Guia · Cerca de 5 minutos

Como conectar o Onplana ao Claude Desktop

Cinco passos. Gere um token, cole o trecho de configuração, reinicie o Claude Desktop e confira com uma chamada de ferramenta. Cerca de 5 minutos no total.

Depois você pode pedir ao Claude coisas como "crie um plano de projeto para o lançamento do Q3 com marcos semanais" ou "resuma os riscos desta semana em todos os projetos ativos", e o Claude faz o trabalho direto no Onplana.

Abrir o Onplana → Configurações → Agentes Baixar o Claude Desktop

Os cinco passos

  1. 1

    Gerar um token de conexão do Onplana

    Entre no Onplana em app.onplana.com. Vá em Configurações → Agentes → Conectar agente, escolha o bloco Claude Desktop (ou Custom MCP client), depois Token de acesso pessoal e então Gerar token + mostrar trecho de conexão. Copie o token de acesso pessoal (ele começa com pat_). O token tem apenas o escopo MCP_AGENT: pode chamar ferramentas MCP, mas não pode criar outros tokens, alterar a cobrança nem mexer em nada fora da superfície MCP.

  2. 2

    Abrir a configuração do Claude Desktop

    No Claude Desktop, clique em Settings → Developer → Edit Config. Isso abre o claude_desktop_config.json no seu editor padrão. No macOS ele fica em ~/Library/Application Support/Claude/claude_desktop_config.json; no Windows, em %APPDATA%\Claude\claude_desktop_config.json. Se o arquivo estiver vazio ou não existir, crie-o com `{}`.

  3. 3

    Colar a configuração do servidor MCP do Onplana

    Adicione uma entrada "onplana" sob a chave "mcpServers". A configuração completa: {"mcpServers": {"onplana": {"url": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}. Troque pat_paste-your-token-here pelo token que você copiou no passo 1. Salve o arquivo.

  4. 4

    Reiniciar o Claude Desktop

    Feche o Claude Desktop por completo (Command+Q no macOS, fechamento total no Windows) e abra de novo. A ferramenta do Onplana deve aparecer no seletor de ferramentas.

  5. 5

    Conferir a conexão

    Numa conversa nova, pergunte: "liste meus projetos do Onplana". O Claude chama a ferramenta list_projects do Onplana e mostra o resultado. Se aparecer um erro, confira o token de novo e veja se o arquivo de configuração é um JSON válido.

claude_desktop_config.json

{
  "mcpServers": {
    "onplana": {
      "url": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      }
    }
  }
}

Como conferir que está funcionando

Abra uma conversa nova no Claude Desktop e tente qualquer uma destas:

  • "Liste meus projetos do Onplana."
  • "O que está atrasado na minha conta do Onplana?"
  • "Crie uma tarefa do Onplana no projeto X chamada ‘Migrar Postgres para Aurora’."
  • "Gere um relatório de status do projeto Y."

O Claude mostra a chamada da ferramenta na conversa antes de executá-la, então você revisa quais dados são lidos ou gravados. As alterações valem em todos os planos; no Free, algumas ações de escrita têm um limite mensal (nenhum a partir do plano Professional), e o agente pode pedir uma prévia que não grava nada pela opção dryRun.

Perguntas frequentes

Qual plano do Onplana inclui o MCP?

O MCP está incluído em todos os planos, inclusive o gratuito. O número de conexões simultâneas de agentes cresce com o plano (Free 2, Professional 3, Business 5, Enterprise 10, Enterprise+ ilimitadas), e o seu saldo de tokens de IA (uma cota mensal nos planos pagos, um bônus único no Free, mais o crédito comprado) é o que limita o uso real de IA. Você troca de plano quando quiser em app.onplana.com/billing.

Existe OAuth como alternativa ao token?

Sim. O Onplana está listado no diretório de Connectors do Claude: no Claude Desktop (ou no claude.ai) abra Settings, encontre Connectors, navegue pelo diretório, escolha o Onplana e aprove o login no navegador, sem colar nada. Por baixo é OAuth 2.1 com PKCE, e o Onplana publica metadados de descoberta conforme a RFC 9728 e a RFC 8414 em https://mcp.onplana.com/.well-known/oauth-protected-resource e oauth-authorization-server. O caminho com o token colado descrito aqui é para quando você quer o arquivo de configuração; o OAuth é para quem prefere não gerenciar tokens de longa duração.

A quais ferramentas o Claude tem acesso?

346 ferramentas: leitura (por ex. list_projects, get_project, list_tasks, list_my_tasks, list_overdue, list_risks, search_org_knowledge, summarize_project, analyze_project_risks, generate_status_report), escrita (por ex. create_project, create_task, update_task, assign_task, create_milestone, create_comment, bulk_update_tasks, create_sprint_with_tasks, submit_timesheet, link_dependency, move_task_to_sprint) e todas as áreas de governança, controle de mudanças, conformidade, documentos e fluxos de trabalho. O plano libera algumas ferramentas; o catálogo completo está em onplana.com/mcp.

O Claude pode excluir projetos ou tarefas pelo MCP?

Sim, de forma recuperável, a menos que um administrador tenha desligado. As ferramentas de exclusão pelo MCP são: excluir uma tarefa, um projeto, uma lista ou um documento. Cada uma é uma chave por espaço de trabalho, ligada até que um administrador salve uma escolha, e quem chama ainda precisa da permissão que precisaria de qualquer forma. Todas excluem de forma reversível para a lixeira, e uma tarefa ou um projeto excluído é guardado com toda a sua subárvore e restaurado com os IDs originais, então as dependências e a hierarquia sobrevivem. Sprints, marcos, épicos e metas não têm nenhuma ferramenta de exclusão pelo MCP.

Posso usar o Claude Code (CLI) em vez do Claude Desktop?

Sim. O Claude Code já vem com suporte a MCP. Instalação em uma linha: `claude mcp add onplana --transport http https://mcp.onplana.com/mcp`. O Claude Code inicia o OAuth na primeira chamada de ferramenta (sem token para colar), abre um navegador para entrar no Onplana e conclui o consentimento; depois, qualquer sessão do `claude` naquele projeto vê o catálogo de ferramentas do Onplana. Para usar um token em vez do OAuth, acrescente `--header "Authorization: Bearer pat_…"` ao comando. Confira com `claude mcp list`. Funciona no macOS, no Linux e no WSL no Windows.

Onde posso revogar a conexão?

No Onplana, Configurações → Agentes → Conexões lista cada conexão, tanto os tokens de acesso pessoal quanto os logins pelo navegador: escolha Revogar na linha. Vale na hora; a próxima chamada de ferramenta do Claude retorna 401 e o Claude pede para você conectar de novo.

O que acontece se meu token vazar?

Revogue-o na hora (veja acima) e gere outro no mesmo painel. O token comprometido deixa de funcionar na próxima chamada. A partir do plano Enterprise, um proprietário ou administrador da organização vê cada chamada que o token vazado fez na página Audit Logs, em Agent Activity, para revisar o que o atacante pode ter visto ou alterado.

Funciona no Linux?

Por enquanto o Claude Desktop existe só para macOS e Windows. No Linux, use outro cliente MCP, como o MCP Inspector oficial (npx @modelcontextprotocol/inspector) ou o Cursor (compatível com Linux), ou ligue a conexão do Onplana a um script de agente local com o SDK cliente tipado em TypeScript do Onplana.

Veja também