O que é o servidor MCP do Chaterimo?

O servidor MCP do Chaterimo disponibiliza 19 ferramentas via Model Context Protocol, permitindo que o Claude AI leia e atualize os dados do seu chatbot em tempo real — incluindo conversas, análises, produtos, leads, tickets e configuração do chatbot.

Preciso de um desenvolvedor para configurar a integração MCP?

Não. O fluxo OAuth do Claude Desktop requer apenas um login no Chaterimo — sem necessidade de programação. Você cola a URL do endpoint nas configurações do Claude Desktop, autoriza via OAuth e está conectado.

O que o Claude pode ler da minha conta Chaterimo via MCP?

Conversas, análises, produtos, leads, tickets, regras de vendas, estatísticas do painel e toda a configuração do chatbot, incluindo modelo de IA, prompt do sistema e aparência do widget.

O Claude pode alterar as configurações do meu chatbot via MCP?

Sim, usando o endpoint de acesso completo. O Claude pode atualizar instruções, modelo de IA, idioma, cores do widget e mensagens, além de acionar o retreinamento. Use o endpoint somente leitura (/mcp-readonly/) para impedir gravações.

A conexão MCP é segura?

Sim. As conexões OAuth usam tokens de curta duração. As conexões por chave de API usam sua chave cha_xxx — trate-a como uma senha e use chaves somente leitura para acesso compartilhado.

Chaterimo MCP Server: Conecte o Claude AI ao Seu Chatbot (2026)

Por David Langr • Atualizado em 2026-05-04 • 10 min de leitura

Use o Claude Desktop ou Claude Code para ler conversas, verificar análises, atualizar instruções de IA e gerenciar o widget do seu chatbot — diretamente no Claude.

Cluster da API de desenvolvedor

Veja também: Atendimento ao cliente com IA para Shopify · Melhor chatbot de IA para Shopify

O que é MCP e por que isso importa para o e-commerce

MCP significa Model Context Protocol — um padrão aberto que permite ao Claude AI se conectar a ferramentas externas e ler dados ao vivo dos seus sistemas em tempo real. Em vez de copiar o histórico de uma conversa do Chaterimo e colar no Claude para análise, você pergunta diretamente: "Quais são as principais reclamações do meu chatbot esta semana?" O Claude chama as ferramentas MCP do Chaterimo, obtém os dados e responde imediatamente.

Para equipes de e-commerce, isso muda a forma como você interage com os dados do seu chatbot. Você não precisa mais fazer login em um painel para verificar análises, ler um ticket ou atualizar suas instruções de IA. Você faz isso dentro de uma conversa no Claude usando linguagem natural.

O servidor MCP do Chaterimo disponibiliza 19 ferramentas que abrangem chatbots, conversas, produtos, tickets, leads e análises. Doze são somente leitura; sete permitem gravações. Você escolhe qual nível de acesso conceder ao Claude com base na forma como se conecta.

      O que você pode fazer com Chaterimo + Claude via MCP
      Pedir ao Claude que resuma as reclamações recentes de clientes do seu chatbot
Fazer o Claude reescrever o prompt do sistema de IA em um estilo mais conciso
Verificar tendências de análises dos últimos 30 dias sem abrir um painel
Pesquisar seu catálogo de produtos e inspecionar padrões de tickets em uma única conversa
Trocar o modelo de IA ou a configuração de idioma do chatbot com uma única instrução

    

Duas formas de conectar: Claude Desktop (OAuth) vs Claude Code CLI

O Chaterimo suporta dois métodos de conexão. O mais adequado depende de quem está se conectando e de como trabalha.

OAuth / Claude Desktop — sem token necessário

Os endpoints OAuth usam o fluxo de autorização MCP padrão. Você cola uma URL no Claude Desktop, autoriza com seu login do Chaterimo e o Claude obtém um token de acesso de curta duração automaticamente. Sem chave de API para gerenciar, sem arquivos de configuração para editar.

Acesso completo (leitura + gravação): https://www.chaterimo.com/mcp/
Somente leitura (seguro para compartilhar): https://www.chaterimo.com/mcp-readonly/

Ideal para: donos de negócios, profissionais de marketing, gerentes de suporte — qualquer pessoa que use o Claude Desktop e queira consultar ou gerenciar seu chatbot sem escrever código.

Chave de API / Claude Code CLI — transporte stdio

A integração via CLI usa FastMCP sobre stdio. Você fornece sua chave de API do Chaterimo (cha_xxx), disponível no painel da API de desenvolvedor, e o Claude Code se conecta diretamente ao processo do servidor MCP.

Ideal para: desenvolvedores que usam o Claude Code no terminal e querem acesso programático integrado ao seu fluxo de trabalho.

URLs tokenizadas legadas: Um terceiro método de conexão — URL direta com token embutido — está disponível para integrações avançadas e pipelines de automação. Entre em contato com o suporte se precisar desse formato.

12 coisas que você pode ler pelo Claude (ferramentas somente leitura)

Todas as ferramentas a seguir estão disponíveis tanto no endpoint de acesso completo quanto no de somente leitura. Elas dão ao Claude uma visão completa da sua conta Chaterimo sem alterar nada.

list_chatbots read

Lista todos os chatbots da sua organização com seus IDs, nomes e modelo de IA atual.

get_chatbot read

Configuração completa do chatbot: modelo de IA, prompt do sistema, temperatura, cores do widget, rótulos dos botões e todas as configurações de aparência.

list_conversations read

Filtre conversas por chatbot, intervalo de datas e plataforma (web, WhatsApp, Facebook Messenger).

get_conversation read

Transcrição completa da conversa com todas as mensagens, timestamps e metadados do visitante. Suporta paginação para sessões longas.

search_products read

Pesquise seu catálogo de produtos sincronizado por palavra-chave — a mesma busca híbrida que seu chatbot usa para responder perguntas sobre produtos.

list_products read

Navegue por todos os produtos sincronizados da sua plataforma de e-commerce, incluindo preço, descrição e disponibilidade.

list_tickets read

Filtre tickets de suporte por status: new, in_progress, resolved ou closed. Útil para identificar padrões de problemas em aberto.

get_ticket read

Detalhes completos do ticket incluindo thread, histórico de status, agente responsável e conversa vinculada.

list_leads read

Todos os leads de visitantes capturados pelo widget de chat — e-mail, nome, data de captura e chatbot de origem.

get_analytics read

Métricas de desempenho do chatbot para qualquer período de até 365 dias: contagem de sessões, volume de mensagens, divisão por plataforma e taxas de resposta.

list_sales_rules read

Veja todas as regras ativas do agente de vendas — os gatilhos e mensagens que seu widget de vendas proativo usa para engajar visitantes.

get_dashboard read

Visão geral do painel: total de sessões, chatbots ativos, divisão por plataforma e resumo de atividade recente.

7 ações que o Claude pode executar no seu chatbot (ferramentas de gravação)

As ferramentas de gravação estão disponíveis apenas no endpoint de acesso completo (/mcp/). Elas permitem que o Claude faça alterações reais na configuração do seu chatbot — útil quando você quer atualizar sua configuração de dentro de uma conversa no Claude sem trocar de aba.

update_chatbot_instructions write

Reescreva o prompt do sistema de IA (máx. 15.000 caracteres). Comprimento recomendado: 15–40 linhas para melhores resultados. As alterações entram em vigor imediatamente.

update_chatbot_model write

Troque o modelo de IA (GPT-4o, Claude Sonnet, Gemini Flash e outros) e defina a temperatura entre 0,1 e 1,0.

update_chatbot_language write

Defina um idioma de resposta fixo ou escolha "Automático" para detectar o idioma de cada visitante e responder de acordo.

update_chatbot_settings write

Atualize o nome e a descrição do chatbot, ative ou desative o widget e ajuste o nível de rigidez do comportamento (o quanto ele segue as fontes da base de conhecimento).

update_widget_appearance write

Defina as cores do widget usando códigos hexadecimais, altere a posição (esquerda, centro, direita) e ajuste o estilo do balão para combinar com sua marca.

update_widget_messages write

Edite a mensagem de boas-vindas, o texto de espaço reservado do campo de entrada, o rótulo da animação de "digitando" e o rótulo do botão de enviar — todos visíveis para os seus visitantes.

retrain_chatbot write

Acione um trabalho completo de retreinamento da base de conhecimento. O chatbot reindexará todas as fontes conectadas: produtos, documentos e conteúdo personalizado.

Passo a passo: configuração do Claude Desktop (OAuth)

Esta é a forma mais rápida de conectar para quem não é desenvolvedor. Sem arquivos de configuração, sem chaves de API — apenas um fluxo OAuth.

Abra o Claude Desktop e navegue até Configurações → Integrações (também listado como "MCP Servers" em algumas versões do aplicativo).
Clique em "Adicionar servidor MCP" e cole uma das seguintes URLs:
- Acesso completo (leitura + gravação): https://www.chaterimo.com/mcp/
- Somente leitura: https://www.chaterimo.com/mcp-readonly/
O Claude Desktop abre uma página de autorização OAuth no seu navegador. Faça login na sua conta Chaterimo e clique em Autorizar. O Claude recebe um token de curta duração automaticamente — você não o vê nem o armazena.
O Claude Desktop agora exibe "Chaterimo" na sua lista de ferramentas com um indicador verde de conectado. As 19 ferramentas (ou 12 ferramentas de somente leitura) já estão disponíveis.
Inicie uma nova conversa e experimente: "Liste meus chatbots" ou "Quais são minhas análises dos últimos 7 dias?" O Claude chamará as ferramentas MCP e retornará uma resposta formatada.

Quando usar o endpoint somente leitura

Use /mcp-readonly/ se quiser dar ao Claude acesso aos seus dados — conversas, análises, tickets — sem permitir que ele altere qualquer configuração do chatbot. Esta é a escolha certa para membros da equipe ou analistas que devem poder consultar dados, mas não modificar a configuração do chatbot em produção.

Passo a passo: configuração do Claude Code CLI

Para desenvolvedores que usam o Claude Code no terminal, o servidor MCP é executado como um processo local via transporte stdio. Você precisará da sua chave de API do Chaterimo, disponível no painel da API de desenvolvedor.

Obtenha sua chave de API: Faça login no Chaterimo → API de Desenvolvedor → Chaves de API → Criar nova chave. A chave começa com cha_.

Adicione o seguinte ao seu .claude/settings.json (ou claude_desktop_config.json para o modo CLI do Claude Desktop):

// .claude/settings.json or claude_desktop_config.json
{
  "mcpServers": {
    "chaterimo": {
      "command": "python",
      "args": ["-m", "developer_api.mcp_server"],
      "env": {
        "CHATERIMO_API_KEY": "cha_your_key_here"
      }
    }
  }
}

Ou execute o servidor diretamente em uma sessão de terminal para testes rápidos:

# Set your key and start the MCP server process
CHATERIMO_API_KEY=cha_xxx python -m developer_api.mcp_server

Uma vez conectado, o Claude Code pode chamar qualquer uma das 19 ferramentas do Chaterimo durante uma sessão. Você verá a saída das chamadas de ferramenta inline enquanto o Claude busca dados da sua conta.

Mantenha sua chave de API em sigilo

Sua chave cha_xxx concede o mesmo nível de acesso que seu login no Chaterimo para operações de API. Não a inclua no controle de versão. Para ambientes compartilhados ou contextos de equipe onde você não quer acesso de gravação, crie uma chave de API somente leitura separada no painel da API de desenvolvedor e use-a.

Exemplos reais de uso

Aqui estão cinco prompts concretos para o Claude que mostram como a integração MCP funciona na prática. Cada prompt aciona ferramentas específicas do Chaterimo automaticamente.

"Liste todos os meus chatbots e me diga qual teve mais conversas este mês."
O Claude chama list_chatbots para obter os IDs dos seus chatbots, depois chama get_analytics para cada um com um intervalo de 30 dias. Ele compara as contagens de sessões e retorna um resumo classificado com o melhor desempenho em destaque.
"Mostre-me as últimas 10 conversas em que um cliente mencionou 'devolução'."
O Claude chama list_conversations para percorrer as sessões recentes, depois chama get_conversation nos candidatos. Ele filtra as transcrições pela palavra-chave e apresenta trechos com timestamps e nomes dos chatbots.
"Reescreva as instruções do chatbot nº 3 para ser mais conciso e amigável."
O Claude chama get_chatbot para ler o prompt do sistema atual, propõe uma versão revisada na conversa para sua revisão e, após sua confirmação, chama update_chatbot_instructions para aplicá-la.
"Mude meu chatbot principal para GPT-4o com temperatura 0,3."
O Claude chama list_chatbots para identificar qual chatbot está marcado como principal, depois chama update_chatbot_model com o modelo alvo e o valor de temperatura. A alteração entra em vigor imediatamente.
"Quais são meus principais tickets de suporte agora e que padrões você vê?"
O Claude chama list_tickets filtrado por status new e in_progress, depois chama get_ticket para cada item em aberto. Ele agrupa os tickets por tema, identifica problemas recorrentes e resume os problemas mais comuns dos clientes em um relatório estruturado.

Somente leitura vs acesso completo: qual você deve usar?

A escolha certa depende da sua função e de quanto você quer que o Claude possa alterar. Na dúvida, comece com somente leitura e atualize quando precisar.

	Somente leitura	Acesso completo
Ver conversas, análises, leads	Sim	Sim
Ler configuração do chatbot e produtos	Sim	Sim
Atualizar instruções do chatbot	Não	Sim
Alterar modelo de IA ou idioma	Não	Sim
Modificar aparência do widget	Não	Sim
Acionar retreinamento	Não	Sim
Endpoint (OAuth)	`/mcp-readonly/`	`/mcp/`
Ideal para	Analistas, membros da equipe	Donos, desenvolvedores

Limites de taxa por plano

As chamadas de ferramenta MCP são contabilizadas na sua cota da API de desenvolvedor. Cada invocação de ferramenta — seja chamada automaticamente pelo Claude durante uma conversa ou acionada manualmente por você — conta como uma chamada de API.

Plano	Chamadas por minuto	Chamadas por dia
Gratuito	5	5
Teste	10	100
Pago	30	1.000

Todas as chamadas de ferramenta são registradas no seu painel do Chaterimo em API de Desenvolvedor → Sessões MCP. Você pode verificar quais ferramentas foram chamadas, quando e quantas chamadas restam na sua cota diária.

Tudo em um só lugar

O servidor MCP do Chaterimo conecta o Claude aos dados ao vivo do seu chatbot — conversas, análises, produtos, tickets e configuração — sem copiar e colar ou trocar de aba. Seja usando o Claude Desktop com OAuth ou o Claude Code com uma chave de API, as mesmas 19 ferramentas estão disponíveis para consultar e gerenciar seu chatbot em linguagem natural.

Sem copiar e colar históricos de conversa no Claude
Faça perguntas em linguagem natural sobre o desempenho do seu chatbot
Atualize as instruções do chatbot de dentro de uma conversa no Claude
Funciona com Claude Desktop (OAuth) e Claude Code (chave de API)
Endpoint somente leitura para compartilhamento seguro com a equipe

Comece Gratuitamente Documentação da API de Desenvolvedor