Integração MCP

O que é o MCP?

O Model Context Protocol (MCP) é um protocolo padronizado para agentes de IA interagirem com ferramentas e fontes de dados externas. Ele oferece uma forma segura e padronizada de assistentes de IA lerem e escreverem em sistemas externos.

Conceitos-chave do MCP

Servidor MCP: um serviço que expõe ferramentas e recursos para agentes de IA
Cliente MCP: um agente de IA ou aplicação que se conecta a servidores MCP
Ferramentas: funções que agentes de IA podem chamar para realizar ações
Recursos: fontes de dados das quais agentes de IA podem ler
Transporte: método de comunicação (somente stdio no Priorize.me)

Arquitetura do servidor MCP do Priorize.me

O servidor MCP do Priorize.me oferece acesso de leitura/escrita a boards e tarefas através de um modelo de autenticação seguro, baseado em sessão.

Transporte

Somente stdio (sem servidor HTTP)

A comunicação acontece exclusivamente por streams de entrada/saída padrão, para mais segurança e integração.

Autenticação

Baseada em sessão, com Supabase

Usa tokens de sessão do Supabase para autenticação. Cada sessão precisa ser explicitamente configurada com os IDs de board permitidos.

Instalação e configuração

1. Tenha o Node.js 24

npx -y @priorize-me/mcp

O servidor é um pacote npm: não há repositório para clonar nem build local. O próprio cliente MCP executa esse comando (veja a configuração do cliente mais abaixo); só é preciso ter o Node.js 24 ou mais recente.

2. Configuração

Crie um arquivo de configuração em um local seguro, fora do repositório:

{
  "supabaseUrl": "https://<project-ref>.supabase.co",
  "supabasePublishableKey": "sb_publishable_<placeholder>",
  "session": {
    "access_token": "<access_token>",
    "refresh_token": "<refresh_token>"
  },
  "allowedBoardIds": ["<board-uuid-1>", "<board-uuid-2>"],
  "allowWrites": false
}

Aviso de segurança

Os arquivos de configuração DEVEM ficar fora do repositório. Nunca faça commit de segredos ou chaves de API no controle de versão.

Gerador de configuração MCP

Preencha seus valores locais para gerar um mcp-config.json. Tudo roda no seu navegador; nenhum valor é enviado.

Guarde este arquivo fora de qualquer repositório.

Ele contém uma sessão pessoal de curta duração (access_token/refresh_token). Nunca faça commit dele nem o coloque em um caminho versionado, e renove a sessão com frequência.

Permitir escrita (criar e atualizar tarefas). Deixe desligado, a não ser em um ambiente local de desenvolvimento.

mcp-config.json

{
  "supabaseUrl": "https://<project-ref>.supabase.co",
  "supabasePublishableKey": "sb_publishable_<placeholder>",
  "session": {
    "access_token": "<access_token>",
    "refresh_token": "<refresh_token>"
  },
  "allowedBoardIds": [],
  "allowWrites": false
}

Preencha os campos obrigatórios para liberar o download. A prévia, com marcadores, pode ser copiada a qualquer momento.

3. Ferramentas disponíveis

O servidor MCP do Priorize.me oferece as seguintes ferramentas:

list_boards - lista todos os boards acessíveis

list_tasks - lista as tarefas de um board

list_board_tags - lista as tags do board

get_task_activity - obtém o histórico de atividade de uma tarefa

create_task - cria uma nova tarefa

update_task - atualiza uma tarefa existente

move_task - move uma tarefa entre quadrantes

complete_task - marca uma tarefa como concluída

discard_task - descarta uma tarefa

reopen_task - reabre uma tarefa concluída/descartada

Modelo de segurança

Autenticação baseada em sessão

Cada sessão MCP exige um token de sessão válido do Supabase. O token precisa ser obtido pelo fluxo de autenticação da aplicação principal.

IDs de board permitidos

A configuração lista explicitamente quais IDs de board a sessão MCP pode acessar. Isso previne o acesso não autorizado a outros boards.

Permissões de escrita

A flag allowWrites controla se a sessão MCP pode realizar operações de escrita. Quando desativada, só operações de leitura são permitidas.

Interseção com RLS

Todas as operações de banco de dados respeitam as políticas de Row Level Security (RLS), garantindo que os usuários só acessem os dados que têm autorização para ver.

Exemplo de configuração de cliente

Configuração do Claude Desktop

{
  "mcpServers": {
    "priorize.me": {
      "command": "npx",
      "args": ["-y", "@priorize-me/mcp"],
      "env": {
        "MCP_LOCAL_CONFIG_PATH": "/path/to/your/config.json"
      }
    }
  }
}

Variáveis de ambiente

O servidor lê exatamente uma variável de ambiente, definida no bloco env da configuração do cliente. Todos os valores do Supabase ficam dentro do arquivo de configuração, nunca no ambiente.

# A única variável de ambiente que o servidor MCP lê:
MCP_LOCAL_CONFIG_PATH=/absolute/path/to/your/mcp-config.json

Solução de problemas

Respostas de erro comuns

VERSION_CONFLICT

A versão da tarefa não coincide - tente buscar o estado mais recente

INVALID_SESSION

O token de sessão expirou ou é inválido

BOARD_NOT_ALLOWED

O ID do board não está na lista allowedBoardIds

WRITE_NOT_ALLOWED

allowWrites está como false, mas uma operação de escrita foi tentada

Problemas de conexão

Verifique se:

O binário do servidor MCP existe e é executável
O caminho do arquivo de configuração está correto e é legível
As credenciais do Supabase são válidas e a sessão está ativa
Os IDs de board permitidos incluem os boards que você está tentando acessar

Problemas de desempenho

Para boards grandes, considere:

Limitar o número de IDs de board permitidos
Usar paginação quando disponível
Filtrar tarefas por status ou quadrante
Usar get_task_activity com paginação por cursor

Fluxos guiados

Percorra fluxos comuns de agentes de IA passo a passo. Os prompts e exemplos de chamada de ferramenta são copiáveis; seu progresso fica salvo localmente no seu navegador.

Assistente de revisão diária de tarefas

0 / 4 concluídas

1. Liste seus boards

Peça ao agente para descobrir os workspaces disponíveis antes de revisar as tarefas.

prompt

Liste meus boards do Priorize.me e me diga quais têm tarefas no quadrante "Fazer".

Preparação de reunião

0 / 3 concluídas

1. Reúna as tarefas relacionadas

Colete as tarefas relevantes para o tema da reunião entre os boards permitidos.

prompt

Encontre tarefas abertas relacionadas a "planejamento do Q3" nos meus boards.

Planejamento de projeto

0 / 3 concluídas

1. Confirme o board de destino

Garanta que o board em que você vai planejar está no seu allowedBoardIds.

tool call

list_boards()

Esta página foi útil?

Última atualização: 30 de setembro de 2026

Precisa de mais ajuda? Confira a documentação completa do MCP ou participe das discussões da comunidade.