Guia de configuração do cliente

Todo cliente MCP inicia o servidor do Priorize.me com o mesmo comando, npx -y @priorize-me/mcp, e passa a ele a variável MCP_LOCAL_CONFIG_PATH. O que muda de um cliente para outro é o arquivo onde esse registro fica.

Antes de começar

1. Node.js 24 ou mais recente instalado (node --version).
2. O arquivo de configuração gerado em Conectar agente (MCP) e salvo fora de qualquer repositório, como mostra o guia de instalação.
3. O caminho absoluto desse arquivo. Caminhos relativos e ~ não funcionam no bloco env da maioria dos clientes.

O registro padrão

{
  "mcpServers": {
    "priorize-me": {
      "command": "npx",
      "args": ["-y", "@priorize-me/mcp"],
      "env": {
        "MCP_LOCAL_CONFIG_PATH": "/caminho/absoluto/para/mcp-config.json"
      }
    }
  }
}

Se o arquivo do cliente já tem outros servidores, acrescente só a entrada priorize-me dentro de mcpServers.

Claude Desktop

Abra Settings → Developer → Edit Config, ou edite o arquivo diretamente:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cole o registro padrão, salve e feche o Claude Desktop por completo (no macOS, Quit; fechar a janela não basta). Ao abrir de novo, as ferramentas do Priorize.me aparecem no menu de ferramentas da conversa. Se não aparecerem, os logs ficam em ~/Library/Logs/Claude/ no macOS e em %APPDATA%\Claude\logs\ no Windows.

Claude Code

Registre o servidor por comando, uma vez para todos os projetos:

claude mcp add --scope user -e MCP_LOCAL_CONFIG_PATH="$HOME/.config/priorize-me/mcp-config.json" \
  priorize-me -- npx -y @priorize-me/mcp

Confira com claude mcp list. Na primeira verificação o status pode aparecer como falha enquanto o npx baixa o pacote; rode de novo após alguns segundos. Dentro de uma sessão, /mcp mostra o servidor e as ferramentas.

Cursor

Edite ~/.cursor/mcp.json para todos os projetos, ou .cursor/mcp.json dentro de um projeto. O formato é o registro padrão. Depois, confira o servidor em Cursor Settings → MCP: ele deve aparecer ativo, com as ferramentas listadas.

Não salve o arquivo de configuração do Priorize.me dentro do projeto: o .cursor/mcp.json só aponta para ele.

Windsurf

Edite ~/.codeium/windsurf/mcp_config.json (ou abra Windsurf Settings → Cascade → MCP Servers → View raw config) e cole o registro padrão. Recarregue a lista de servidores no painel do Cascade.

VS Code

O VS Code usa a chave servers em .vscode/mcp.json, no projeto, ou no arquivo aberto por MCP: Open User Configuration:

{
  "servers": {
    "priorize-me": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@priorize-me/mcp"],
      "env": {
        "MCP_LOCAL_CONFIG_PATH": "/caminho/absoluto/para/mcp-config.json"
      }
    }
  }
}

Outros clientes

Qualquer cliente que inicie servidores MCP por stdio funciona. Informe:

• comando: npx
• argumentos: -y, @priorize-me/mcp
• variável de ambiente: MCP_LOCAL_CONFIG_PATH com o caminho absoluto do arquivo de configuração

Num cliente próprio, com o SDK oficial @modelcontextprotocol/client:

import { Client } from '@modelcontextprotocol/client';
import { StdioClientTransport } from '@modelcontextprotocol/client/stdio';

const client = new Client({ name: 'meu-cliente', version: '1.0.0' });
await client.connect(
  new StdioClientTransport({
    command: 'npx',
    args: ['-y', '@priorize-me/mcp'],
    env: {
      PATH: process.env.PATH ?? '',
      MCP_LOCAL_CONFIG_PATH: '/caminho/absoluto/para/mcp-config.json',
    },
  }),
);

const { tools } = await client.listTools();
console.log(tools.map((tool) => tool.name));
await client.close();

Particularidades por sistema

macOS e Linux

Se você instalou o Node por um gerenciador de versões (nvm, fnm, asdf, mise), um cliente aberto pelo Dock ou pelo menu do sistema pode não enxergar o npx. Use o caminho completo em command, descoberto com which npx:

{
  "command": "/Users/<você>/.nvm/versions/node/v24.0.0/bin/npx",
  "args": ["-y", "@priorize-me/mcp"]
}

Windows

Use barras invertidas duplas nos caminhos do JSON. Se o cliente não conseguir iniciar o npx diretamente, inicie-o pelo cmd:

{
  "mcpServers": {
    "priorize-me": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@priorize-me/mcp"],
      "env": {
        "MCP_LOCAL_CONFIG_PATH": "C:\\Users\\<você>\\AppData\\Roaming\\priorize-me\\mcp-config.json"
      }
    }
  }
}

No WSL, instale o Node dentro da distribuição e use os caminhos do Linux; o cliente no Windows inicia o servidor com wsl como comando e npx nos argumentos.

Problemas comuns

Mais casos no guia de solução de problemas.

Boas práticas

• Use um arquivo de configuração por conta. Para separar boards de trabalho e pessoais, gere duas configurações e registre duas entradas com nomes diferentes.
• Deixe allowWrites: false enquanto o agente só precisa ler.
• Nunca coloque o arquivo de configuração num repositório, mesmo privado.

Próximos passos

1. Experimente fluxos de exemplo: tutoriais de uso
2. Revise a segurança: guia de segurança
3. Resolva problemas: guia de solução de problemas