Guia · Cerca de 5 minutos

Como conectar o Onplana ao Cursor

Cinco passos. Gere um token, cole o trecho mcpServers, recarregue o Cursor e confira com uma chamada de ferramenta. Cerca de 5 minutos.

Depois você pode pedir ao Agent do Cursor 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 Cursor faz o trabalho direto no Onplana sem sair do editor.

Abrir o Onplana → Configurações → Agentes Documentação MCP do Cursor

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 Cursor (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 as configurações MCP do Cursor

    No Cursor, abra Settings (Command+Shift+J no macOS, Ctrl+Shift+J no Windows ou Linux), vá em Tools & MCP e escolha New MCP Server. O Cursor também lê uma configuração JSON diretamente: do projeto em .cursor/mcp.json na raiz do seu repositório, ou global em ~/.cursor/mcp.json. Editar o JSON dá o mesmo resultado que a interface.

  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 do passo 1. Salve o arquivo.

  4. 4

    Recarregar o Cursor

    Recarregue a janela do Cursor (Command+Shift+P ou Ctrl+Shift+P, depois "Reload Window"), ou desligue e ligue o servidor onplana em Settings, depois Tools & MCP. As ferramentas do Onplana aparecem na lista de ferramentas do Agent com um ponto de status verde assim que o handshake funciona.

  5. 5

    Conferir a conexão

    No chat do Agent do Cursor, pergunte: "liste meus projetos do Onplana". O Cursor 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.

.cursor/mcp.json (projeto) ou ~/.cursor/mcp.json (global)

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

Como conferir que está funcionando

Abra o chat do Agent do Cursor 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 Cursor mostra a chamada da ferramenta 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.

O suporte a MCP do Cursor é estável?

Sim, o MCP é um recurso já lançado no Cursor e não uma prévia. A conexão do Onplana é associada ao provedor CURSOR e recebe todas as ferramentas de leitura, criação e atualização. Ainda assim, as configurações do Cursor podem mudar de lugar entre versões; se isso acontecer, veja o local atual em docs.cursor.com e mantenha a mesma entrada do servidor onplana.

Configuração do projeto ou global?

Qualquer uma. O .cursor/mcp.json na raiz de um repositório limita a conexão àquele projeto (útil quando repositórios diferentes correspondem a organizações diferentes do Onplana com tokens separados). O ~/.cursor/mcp.json aplica a conexão a todas as janelas do Cursor. Se as duas definirem um servidor "onplana", vale a do projeto.

A quais ferramentas o Cursor tem acesso?

Ao mesmo catálogo de 346 ferramentas que todo cliente MCP vê: leitura (list_projects, get_project, list_tasks, list_my_tasks, list_overdue, list_risks, search_org_knowledge, summarize_project, generate_status_report), escrita (create_project, create_task, update_task, assign_task, create_milestone, create_comment, bulk_update_tasks, create_sprint_with_tasks, link_dependency) e 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 Cursor 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.

Existe OAuth em vez de colar um token?

O Onplana publica metadados de descoberta do OAuth 2.1 (RFC 9728 e RFC 8414) em mcp.onplana.com/.well-known/. Se o Cursor os usa automaticamente depende do suporte à autenticação MCP da sua versão do Cursor; o caminho com o token no cabeçalho descrito aqui funciona em todas as versões que aceitam servidores MCP remotos.

Onde revogo a conexão?

No Onplana, em Configurações, depois Agentes, depois Conexões, e Revogar na linha do token. Vale na hora; a próxima chamada de ferramenta do Cursor retorna 401. A partir do plano Enterprise, um proprietário ou administrador da organização vê cada chamada que o token fez na página Audit Logs, em Agent Activity.

Veja também