MCP no Claude Code

O Claude Code (a ferramenta de linha de comando da Anthropic) suporta servidores MCP por HTTP nativamente.

Instalar

Gere uma chave em Configurações → Desenvolvedor. Para começar, prefira Somente leitura.

No terminal, rode (troque tt_live_SUA_CHAVE pela sua chave):

claude mcp add --transport http toptalking https://platform.toptalking.com.br/mcp --header "Authorization: Bearer tt_live_SUA_CHAVE"

Confira se conectou:
Janela do terminal
```
claude mcp list
```
Dentro do Claude Code, o comando /mcp mostra o status e as ferramentas da toptalking.
Peça algo como: “Use a TopTalking para listar as etapas do Kanban e quantos contatos há em cada uma.”

Escopos

Por padrão o servidor fica disponível só para você, no projeto atual (--scope local). Outras opções:

Escopo	Comando	Onde fica
Só você, este projeto	`--scope local` (padrão)	Configuração local do Claude Code
Só você, todos os projetos	`--scope user`	Configuração do seu usuário
Todo o time, este projeto	`--scope project`	Arquivo `.mcp.json` na raiz do repositório

# Disponível em todos os seus projetos
claude mcp add --transport http --scope user toptalking https://platform.toptalking.com.br/mcp --header "Authorization: Bearer tt_live_SUA_CHAVE"

Compartilhar com o time sem expor a chave

O .mcp.json vai para o Git. Não coloque a chave nele: use uma variável de ambiente, que o Claude Code expande ao carregar o arquivo.

{
  "mcpServers": {
    "toptalking": {
      "type": "http",
      "url": "https://platform.toptalking.com.br/mcp",
      "headers": {
        "Authorization": "Bearer ${TOPTALKING_API_KEY}"
      }
    }
  }
}

Cada pessoa define TOPTALKING_API_KEY na própria máquina (de preferência com a própria chave).

Permissões

O Claude Code pede confirmação antes de usar uma ferramenta MCP. Você pode liberar de vez só as ferramentas de leitura e continuar aprovando manualmente as que enviam mensagens:

{
  "permissions": {
    "allow": [
      "mcp__toptalking__get_account",
      "mcp__toptalking__list_channels",
      "mcp__toptalking__search_contacts",
      "mcp__toptalking__get_contact",
      "mcp__toptalking__list_messages",
      "mcp__toptalking__list_stages",
      "mcp__toptalking__list_scheduled_messages",
      "mcp__toptalking__list_groups",
      "mcp__toptalking__list_members",
      "mcp__toptalking__list_ai_agents",
      "mcp__toptalking__list_templates",
      "mcp__toptalking__list_campaigns",
      "mcp__toptalking__get_channel_qr"
    ]
  }
}

Remover

claude mcp remove toptalking

Próximos passos

Quer que o Claude Code escreva uma integração com a API (e não só use o MCP)? Veja o guia Claude, com um CLAUDE.md pronto.
Todas as ferramentas e cuidados: Servidor MCP.