Guia · Cerca de 5 minutos

Como conectar o Onplana ao Windsurf

Cinco passos. Gere um token, cole o trecho mcpServers (o Windsurf usa serverUrl), atualize o Cascade e confira com uma chamada de ferramenta. Cerca de 5 minutos.

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

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

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 Windsurf (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 MCP do Windsurf Cascade

    No Windsurf, abra o painel Plugins (MCP) e escolha "View raw config". Isso abre o mcp_config.json. No macOS e no Linux ele fica em ~/.codeium/windsurf/mcp_config.json; no Windows, na pasta .codeium\windsurf do seu perfil de usuário. Se o arquivo estiver vazio, comece 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": {"serverUrl": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}. O Windsurf usa a chave "serverUrl" para servidores HTTP remotos (não "url"). Troque pat_paste-your-token-here pelo token do passo 1 e salve.

  4. 4

    Atualizar o Cascade

    No painel Plugins (MCP), clique em "Refresh" (a seta circular) para o Cascade reler a configuração e fazer o handshake MCP. O servidor onplana deve mostrar um status verde e uma contagem de ferramentas disponíveis. O Cascade mantém no máximo 100 ferramentas MCP ativas e o Onplana expõe 346, então, se faltarem ferramentas do Onplana, desligue outros servidores ou ferramentas de que você não precisa.

  5. 5

    Conferir a conexão

    No Cascade, pergunte: "liste meus projetos do Onplana". O Windsurf chama a ferramenta list_projects do Onplana e mostra o resultado. Se aparecer um erro, confira o token de novo, veja se a chave é "serverUrl" (não "url") e se o JSON é válido.

~/.codeium/windsurf/mcp_config.json

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

Como conferir que está funcionando

Abra o Cascade 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 Cascade 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.

Por que o Windsurf usa "serverUrl" em vez de "url"?

É o esquema de configuração do Windsurf para servidores MCP remotos via HTTP. O Claude Desktop e o Cursor usam "url"; o Windsurf Cascade usa "serverUrl". O resto da entrada (o nome do servidor onplana e o cabeçalho Authorization) é idêntico. Usar "url" por engano é o motivo mais comum de uma conexão do Windsurf não aparecer sem nenhum aviso.

O suporte a MCP do Windsurf é estável?

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

A quais ferramentas o Windsurf 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 Windsurf 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.

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 Windsurf 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