MCP

MCP da XBASE: use a XBASE pelo Claude e pelo Cursor

Conecte o Claude Code, o Cursor ou outro cliente MCP ao seu workspace da XBASE: token de acesso, endereço do servidor e a lista de ferramentas.

Atualizado em

O MCP da XBASE deixa um agente de IA, como o Claude Code ou o Cursor, ler e editar o seu workspace conversando em linguagem natural: WhatsApp, Instagram, agentes de IA, automações, contatos, conversas e funis. São 198 ferramentas.

MCP (Model Context Protocol) é o padrão aberto que esses agentes usam para se conectar a outros sistemas.

Como funciona

  • Endereço do servidor: https://mcp.xbase.app/mcp (transporte HTTP).
  • Acesso por token: cada conexão usa um token de acesso MCP do workspace, que começa com xmcp_.
  • Preso ao workspace: o token só lê e edita o workspace em que foi criado, mesmo que o agente peça outro.
  • Os seus cargos valem: o token age como a pessoa que o criou. Se ela não pode editar agentes na XBASE, o agente de IA também não pode.
  • Você revoga quando quiser: o token para de funcionar na hora.

Criar o token

  1. Na XBASE, abra Integrações, vá à aba Agentes & APIs e encontre o card Acesso MCP. É preciso ter permissão para gerenciar integrações.
  2. Clique em Novo token (ou em Conectar Integração, se for o primeiro).
  3. Em Nome, escreva algo que identifique o uso, como "Claude Code do Marco", e clique em Criar token.
  4. A janela Token criado mostra o Token, a URL do servidor MCP e o comando pronto do Claude Code (terminal). Copie agora: o token não aparece de novo.
  5. Clique em Pronto, já copiei.

O card lista os tokens com os 4 últimos caracteres, a data de criação e o último uso. Para cortar o acesso, clique em Revogar.

Conectar no Claude Code

No terminal, rode o comando que a janela Token criado mostra, trocando xmcp_... pelo seu token:

claude mcp add --transport http xbase https://mcp.xbase.app/mcp --header "Authorization: Bearer xmcp_..."

Depois, peça em linguagem natural. Exemplos:

  • "Liste os templates de WhatsApp aprovados do meu workspace."
  • "Crie uma resposta rápida chamada horário com o nosso horário de atendimento."
  • "Mostre as conversas de hoje que estão no estágio Proposta."

Conectar no Cursor e em outros clientes MCP

Qualquer cliente MCP com transporte HTTP funciona. Informe a URL do servidor e o cabeçalho de autorização. No Cursor, no arquivo de configuração de MCP (.cursor/mcp.json):

{
  "mcpServers": {
    "xbase": {
      "url": "https://mcp.xbase.app/mcp",
      "headers": { "Authorization": "Bearer xmcp_..." }
    }
  }
}

Ferramentas

A lista completa, gerada do código do servidor, fica numa página por área (ao lado, em Ferramentas). Onde a ferramenta pede workspaceId, só vale o id do workspace do token: se o agente mandar outro, o MCP recusa e responde com o id certo.

Regras e limites

  • O token não escolhe ferramentas: ele libera todas as da lista, sempre limitadas aos cargos de quem o criou.
  • As ações têm efeito real: enviar, editar e excluir pelo MCP é igual a fazer pela tela. Ações de excluir não têm volta.
  • Quem deixa de ser membro do workspace invalida os tokens que criou.
  • Guarde o token como uma senha. Se ele vazar, revogue em Integrações → Acesso MCP e crie outro.

Perguntas frequentes

Veja também

Nesta página