Guia de instalação e configuração

O servidor MCP do Priorize.me roda na sua máquina e conecta um agente de IA, como Claude Desktop, Claude Code ou Cursor, aos boards que você liberar. Ele é distribuído no npm como @priorize-me/mcp: o cliente MCP o baixa e o inicia com npx. Você não precisa clonar repositório, compilar código nem rodar banco de dados.

Pré-requisitos

1. Node.js 24 ou mais recente. Confira com node --version. O npx vem junto com o Node.
2. Uma conta no Priorize.me com acesso ao board que o agente vai usar.
3. Um cliente compatível com MCP: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code ou outro que inicie servidores por stdio.

Passo 1: gere a configuração no app

O app gera um arquivo de configuração pronto, com uma sessão só para o servidor MCP, separada da sessão do navegador:

1. Entre no Priorize.me e abra o board que o agente vai usar.
2. Clique no seu avatar (as iniciais no canto superior direito do board) e escolha Conectar agente (MCP).
3. Clique em Gerar configuração e depois em Copiar configuração.
4. Salve o conteúdo num arquivo fora de qualquer repositório e só legível por você:

mkdir -p ~/.config/priorize-me
# Cole o conteúdo copiado neste arquivo e salve
nano ~/.config/priorize-me/mcp-config.json
chmod 600 ~/.config/priorize-me/mcp-config.json

No Windows, use por exemplo C:\Users\<você>\AppData\Roaming\priorize-me\mcp-config.json.

O arquivo tem este formato (os valores reais vêm do app):

{
  "supabaseUrl": "https://<project-ref>.supabase.co",
  "supabasePublishableKey": "sb_publishable_<placeholder>",
  "session": {
    "access_token": "<access-token-gerado-pelo-app>",
    "refresh_token": "<refresh-token-gerado-pelo-app>"
  },
  "allowedBoardIds": ["<board-uuid>"],
  "allowWrites": false
}

A configuração vem com o board aberto em allowedBoardIds e allowWrites: false. Para liberar outro board, acrescente o UUID dele à lista. Para deixar o agente criar e mudar tarefas, troque allowWrites para true.

Por segurança, o botão Gerar configuração só funciona até 10 minutos depois de você entrar no app, e no máximo 5 vezes por hora. Se aparecer o aviso para entrar de novo, use Sair e entrar de novo e gere a configuração em seguida.

Passo 2: adicione o servidor ao cliente MCP

Na configuração do seu cliente, registre o comando npx -y @priorize-me/mcp com a variável MCP_LOCAL_CONFIG_PATH apontando para o arquivo do passo 1, com caminho absoluto. O próprio diálogo Conectar agente (MCP) mostra este bloco pronto para copiar:

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

No Claude Code, o mesmo registro é um comando:

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

Onde fica a configuração de cada cliente está no guia de configuração do cliente.

Passo 3: reinicie o cliente e teste

Reinicie o cliente MCP. Na primeira vez, o npx baixa o pacote, o que pode levar alguns segundos. Depois peça ao agente:

• "Quais boards eu tenho no Priorize.me?"
• "Liste as tarefas do Backlog deste board."

Se o agente listar o board, a instalação terminou.

Como o servidor usa a configuração

• Ele lê uma única variável de ambiente, MCP_LOCAL_CONFIG_PATH. A sessão, os boards liberados e a permissão de escrita vêm só desse arquivo, nunca de argumentos de ferramenta.
• Ele renova a própria sessão enquanto roda e grava os tokens novos no mesmo arquivo, com permissão 600. Por isso o arquivo precisa ser gravável por quem roda o cliente.
• Uma chamada só alcança a interseção de allowedBoardIds com o que a sua conta já pode ver. O arquivo não dá acesso que a sua conta não tem.

Atualizar, desativar e revogar

• Atualizar: o npx -y usa a versão mais recente publicada. Se o cache do npm guardou uma versão antiga, troque o argumento por @priorize-me/mcp@latest uma vez e reinicie o cliente.
• Desativar: remova a entrada priorize-me do cliente ou encerre o processo.
• Revogar: saia de todas as sessões da conta no Priorize.me e apague o arquivo de configuração. Apagar só o arquivo não invalida a sessão que estava nele.

Problemas comuns

O servidor registra cada falha de inicialização no stderr como {"level":"error","message":"Startup blocked","meta":{"reason":"..."}}. O motivo nunca repete o conteúdo do arquivo, porque ele contém os tokens. O servidor não tem --help: sem MCP_LOCAL_CONFIG_PATH, ele encerra na hora com esse aviso.

Se o cliente diz que não encontrou npx, ele não está vendo o Node instalado. Use o caminho completo do npx em command (descubra com which npx ou where npx) ou veja as particularidades de cada sistema no guia de configuração do cliente.

Para testar fora do cliente, rode o mesmo comando no terminal. Ele fica esperando mensagens MCP na entrada padrão; encerre com Ctrl+C:

MCP_LOCAL_CONFIG_PATH="$HOME/.config/priorize-me/mcp-config.json" npx -y @priorize-me/mcp

Próximos passos

1. Configure outro cliente: guia de configuração do cliente
2. Veja as ferramentas disponíveis: referência de ferramentas MCP
3. Teste fluxos de exemplo: tutoriais de uso