Conecte seus assistentes de IA favoritos (Claude, ChatGPT, Gemini) diretamente à sua conta Clara para gerenciar suas finanças corporativas em tempo real.
Antes de começar: você não precisa mais gerar nenhum token. Ao conectar sua ferramenta de IA, será solicitado que você faça login com sua conta Clara — o mesmo usuário e senha (ou Google, Microsoft ou passkey) que você usa para entrar na plataforma.
Veja mais em Clara MCP — O que é e como obter acesso
O que você vai precisar
- Sua conta Clara está ativa (função Administrador ou Contador).
- Uma ferramenta de IA compatível:
- Claude Desktop / Claude Web: Recomendado.
- Claude Code: Para uso técnico no terminal (CLI).
- ChatGPT: via conectores personalizados (requer ativar o Modo desenvolvedor).
- Outras: Gemini (via Google AI Studio) ou outra ferramenta — sujeito a que suporte conectores remotos com autenticação OAuth.
A URL do servidor MCP correspondente ao seu país (veja tabela abaixo).
🌎 URL do servidor por país
| País | URL do servidor MCP |
| México | https://api.clara.team/mcp |
| Colombia | https://api-gw-co-prod.clara.com/mcp |
| Brasil | https://api-prod.br.clara.com/mcp |
⚙️ Passo 1: Conecte sua ferramenta ao Clara MCP
Opção A - Claude Web / Claude Desktop
O processo de configuração é idêntico no Claude Web e no Claude Desktop. Siga os passos abaixo.
Para novos usuários
Claude Web
Nota: Estas instruções são para uma conta individual. Em contas Team/Enterprise, a organização pode restringir a configuração de conectores personalizados apenas para administradores.
1. Vá em Configurações > Conectores
2. No canto superior direito, clique em Adicionar > Adicionar conector personalizado
3. Insira um nome e a URL do servidor MCP do seu país.
4. Clique em Adicionar e depois em Conectar - você será redirecionado para a tela de login da Clara.
5. Complete o fluxo de OAuth
Claude Desktop
Para o Claude Desktop, siga o mesmo processo do Claude Web:
Abra as Configurações do Claude Desktop
Vá para a seção de Conectores
Adicione um novo conector personalizado
Insira a URL do servidor MCP e complete o fluxo de OAuth
Para clientes antigos / Migração
Se você já tinha o Clara MCP configurado com o sistema anterior, precisa atualizar sua configuração:
Claude Desktop:
Em vez de usar supergateway, você precisa usar mcp-remote para suportar os fluxos OAuth:
"clara-br": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"<https://api-prod.br.clara.com/mcp>"
]
}
Ao configurar dessa forma, a página de login será aberta automaticamente quando você reiniciar o Claude Desktop.
Claude Web:
Basta remover a configuração anterior e seguir os passos de "Para novos usuários" acima.
Opção B - Claude Code
Para novos usuários
Execute no terminal (fora do Claude Code) o seguinte comando:
claude mcp add --transport http clara-mx <https://api-prod.br.clara.com/mcp>
(Ajuste a URL de acordo com seu país: api.clara.team/mcp para MX, api-gw-co-prod.clara.com/mcp para CO, api-prod.br.clara.com/mcp para BR)
2. Abra o Claude Code e execute /mcp para selecionar o servidor MCP
3. Selecione "Authenticate" - você será redirecionado para o fluxo de OAuth
Para usuários atuais / Migração
Os usuários atuais precisarão fazer login para continuar usando o MCP, já que o header token original não é reconhecido pelo novo servidor MCP.
Siga os passos de "Para novos usuários" acima para completar a migração.
Opção C - ChatGPT
Habilitar conectores personalizados
Primeiro, habilite o Modo Desenvolvedor:
Vá em Perfil > Configurações > Segurança e login, e ative o Modo desenvolvedor
Adicionar Clara MCP
Vá em Complementos e clique no botão + no canto superior direito
Insira:
Nome: "Clara MX" (ou "Clara CO", "Clara BR"). Este nome é puramente informativo
Conexão: a URL do servidor MCP do seu país
Autenticação: OAuth
Clique em Criar. Aparecerá um modal dizendo "Adicionar Clara MX ao ChatGPT". Pressione "Fazer login com Clara MX", o que vai redirecioná-lo para o fluxo de OAuth.
Opção D - Outras ferramentas
Para outras ferramentas de IA (Gemini, etc.), siga um processo similar:
Procure a seção "Conectores" ou "Integrações" na sua ferramenta
Adicione um novo conector personalizado
Insira a URL do servidor MCP do seu país
Complete o fluxo de OAuth
Se você tiver problemas com uma ferramenta específica, entre em contato com o suporte.
👥 Se você administra mais de uma empresa
Ao se conectar, o Clara MCP inicia sessão na última empresa que você usou na plataforma web/app. Para trocar de empresa dentro da mesma conversa, você pode pedir ao seu assistente:
"A quais empresas eu tenho acesso?"
"Mude para a empresa [nome]"
✅ Passo 2: Verifique sua conexão
Depois de conectado, faça uma pergunta de teste:
"Liste meus cartões da Clara"
"Mostre minhas últimas 10 transações"
🛡️ Gestão e segurança do acesso
Seu acesso via IA está vinculado à sua sessão da Clara — não existe um token separado que você possa perder ou compartilhar por engano.
Para revogar o acesso, faça a solicitação através da equipe de customer happiness: Chat na plataforma ou contacto@clara.com
❓ Solução de problemas comuns
Pede para fazer login novamente: sua sessão expirou — é normal, apenas autentique-se novamente.
A ferramenta não aparece: feche completamente o app (Quit, não apenas a janela) e abra-o novamente após conectar.
Já tinha o Clara MCP conectado e parou de funcionar: o método anterior (token estático) não é mais válido — siga os passos de "Se você já tinha o Clara MCP conectado" na ferramenta que você usa, acima.
Resposta "Ok" ao bloquear o cartão: limitação conhecida da fase Beta; a operação é executada mesmo que a resposta seja simples.
Contador em 0: em alguns casos o resumo de transações mostra 0, mas o detalhamento das movimentações aparece corretamente abaixo.