Configuração do MCP Server

Conectado em minutos:
Claude, ChatGPT e qualquer cliente MCP

Aponte o seu assistente de IA para o seu endpoint MCP da Smartico e faça login com a sua conta do back office, ou use um token de acesso para scripts e ferramentas de linha de comando. Não há nada para instalar.

Três passos para conectar

  1. 1Ative o MCPPeça ao seu gerente de conta para ativar o MCP no seu label e confirmar o seu endpoint. O formato é https://aichat-api<N>.smartico.ai/mcp.
  2. 2Escolha quem tem acessoUm administrador define um perfil de acesso MCP para cada usuário do back office. Novos usuários começam sem acesso.
  3. 3Conecte e pergunteAdicione o endpoint ao seu assistente, use o Sign in with Smartico ou um token de acesso e faça a sua primeira pergunta.

Veja a configuração

Uma configuração real no Claude: adicione a Smartico como conector personalizado, cole o link MCP, entre com a Smartico e escolha as labels. As ferramentas da Smartico ficam prontas na hora.

  • Adicione um conector. No Claude: Settings, Connectors, Add.
  • Cole o link. O Claude encontra sozinho o login da Smartico.
  • Entre. Escolha as labels que o Claude pode usar e aprove.
  • Pronto. Cada ferramenta pede seu OK antes de rodar.

Sign in with Smartico

Adicione o endpoint ao seu assistente como conector e escolha Sign in with Smartico. Uma página da Smartico se abre: faça login com a sua conta do back office, escolha os labels que deseja liberar e aprove.

  • Nenhum token para copiar ou guardar.
  • As alterações ficam registradas no seu próprio nome.
  • Funciona no Claude, ChatGPT, Cursor, Windsurf e Gemini.
  • No ChatGPT, adicione um conector personalizado em Settings, Apps & Connectors. Alguns planos exigem o Developer mode para conectores personalizados.
Configurações do conector
Nome
Smartico
Endereço
https://aichat-api<N>.smartico.ai/mcp
Autenticação
OAuth

Tokens de acesso para scripts e ferramentas

Para ferramentas que não fazem login, crie um token com nome em MCP, Access tokens: escolha o perfil de acesso e os labels dele e copie o token. Ele aparece completo só uma vez.

  • O Claude Code se conecta com um único comando.
  • O Cursor e outros clientes MCP recebem o token na própria configuração MCP.
  • Crie um token para cada ferramenta, integração ou colega e desative qualquer um deles na hora.
  • Trate um token como uma senha.
Claude Code
claude mcp add --transport http smartico \
  https://aichat-api<N>.smartico.ai/mcp \
  --header "Authorization: Bearer <token>"

O seu próprio código

O mesmo endpoint é uma API JSON-RPC 2.0 padrão, então scripts e integrações podem chamar as ferramentas diretamente.

  • Cada requisição é independente: não há sessão para abrir antes.
  • Adicione o cabeçalho x-mcp-mode: json para receber os resultados em JSON.
  • As alterações feitas com um token ficam registradas em nome de um usuário AI/API dedicado.
  • Se a sua conta usa uma lista de IPs permitidos, as requisições MCP também seguem essa lista. Para o ChatGPT, adicione os endereços IP de conectores que a OpenAI publica.
Liste as ferramentas que um token pode usar
curl -X POST https://aichat-api<N>.smartico.ai/mcp \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-mcp-mode: json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

FAQ

A qual endereço nos conectamos?
Como começamos?
Precisamos de um token de acesso?