Guia · Servidor MCP para o Claude
Servidor MCP do Chaterimo: conecte o Claude ao seu chatbot
Adicione o Chaterimo ao Claude como conector personalizado: leia conversas, tickets e análises ou mude as configurações do chatbot. Uma URL e login OAuth.
Em resumo
- 01O servidor MCP do Chaterimo permite que o Claude leia os seus dados do Chaterimo (conversas, análises, produtos, tickets, leads, regras de vendas e entradas de texto da base de conhecimento) e, com acesso total, mude as configurações do chatbot.
- 02Você o adiciona no Claude como conector personalizado com uma única URL e entra com a sua conta do Chaterimo (OAuth); não é preciso código nem chave de API.
- 03A URL somente leitura (https://www.chaterimo.com/mcp-readonly) dá ao Claude 14 ferramentas que apenas leem; a URL de acesso total (https://www.chaterimo.com/mcp) acrescenta 10 ferramentas que alteram o chatbot no ar.
- 04As chamadas são limitadas por organização: 5 por dia sem plano, 100 por dia no teste e 1.000 por dia em um plano pago.
- 05O Claude Code pode usar as mesmas URLs como servidor MCP remoto; clientes sem OAuth usam uma URL com token da página API para Desenvolvedores.
O que você precisa
- Uma conta do Chaterimo. Todos os planos e o teste grátis podem usar o servidor MCP; o limite diário depende do plano.
- Uma conta do Claude. Os conectores personalizados funcionam nos planos Free, Pro, Max, Team e Enterprise; o Free permite um conector personalizado.
- No Claude Team ou Enterprise: um proprietário da organização do Claude adiciona o conector primeiro.
Conteúdo 8
O servidor MCP do Chaterimo conecta o Claude à sua conta do Chaterimo. Assim, o Claude pode ler as conversas, as análises, os produtos, os tickets e os leads do seu chatbot e, com acesso total, mudar as configurações do chatbot, tudo a partir de um chat do Claude. Você o adiciona no Claude como conector personalizado com uma única URL e entra com a sua conta do Chaterimo; não é preciso código. O MCP (Model Context Protocol) é um padrão de código aberto que permite que aplicativos de IA como o Claude se conectem a ferramentas e dados de outros sistemas.1
O que o Claude pode ler e mudar
O Chaterimo oferece duas URLs de conector. As duas mostram ao Claude apenas os dados da organização que você escolhe ao entrar.
| Acesso | URL | Ferramentas | O que o Claude pode fazer |
|---|---|---|---|
| Somente leitura | https://www.chaterimo.com/mcp-readonly |
14 | Ler dados; não muda nada |
| Acesso total | https://www.chaterimo.com/mcp |
24 | Ler dados e mudar o chatbot |
As ferramentas por área (uma ferramenta é uma ação que o Claude pode chamar):
| Área | Ferramentas de leitura (as duas URLs) | Ferramentas de escrita (só acesso total) |
|---|---|---|
| Chatbots | list_chatbots, get_chatbot |
update_chatbot_instructions, update_chatbot_model, update_chatbot_language, update_chatbot_settings |
| Janela de chat | em get_chatbot |
update_widget_appearance, update_widget_messages |
| Conversas | list_conversations, get_conversation |
nenhuma |
| Produtos | search_products, list_products |
nenhuma |
| Tickets | list_tickets, get_ticket |
nenhuma |
| Leads | list_leads |
nenhuma |
| Análises | get_analytics, get_dashboard |
nenhuma |
| Regras de vendas | list_sales_rules |
nenhuma |
| Base de conhecimento (entradas de texto) | list_knowledge_base_entries, get_knowledge_base_entry |
create_knowledge_base_entry, update_knowledge_base_entry, delete_knowledge_base_entry, retrain_chatbot |
As ferramentas de escrita alteram diretamente o chatbot que está no ar; não existe rascunho. Uma entrada de texto nova ou alterada chega ao chatbot depois de retrain_chatbot ou do treinamento noturno. As ferramentas da base de conhecimento veem apenas as entradas cadastradas como texto (Base de Conhecimento → Obter Dados → Entrada de Texto). Páginas rastreadas, arquivos enviados e feeds de produtos ficam fora do alcance delas. As conversas de teste de Testar chatbot ficam de fora das ferramentas de conversas.
Passo a passo
1Escolha somente leitura ou acesso total
Comece com a URL somente leitura. Ela basta para resumos das conversas recentes, tickets abertos, leads novos e análises. Use a URL de acesso total só quando quiser que o Claude reescreva as instruções do chatbot, troque o modelo de IA, mude a janela de chat ou edite entradas de texto da base de conhecimento. Em um plano pago do Claude, você pode adicionar as duas, como dois conectores com nomes diferentes.
2Copie a URL do conector no Chaterimo
No Chaterimo, abra API para Desenvolvedores no menu (em Conta). Expanda Conector MCP para Claude Desktop / Cowork. Em Copie este URL:, copie a URL somente leitura. Para acesso total, abra Precisa de acesso de escrita? Use o URL de acesso total e copie essa outra.
3Adicione um conector personalizado no Claude
No Claude na web ou no aplicativo Claude para desktop, abra Customize → Connectors, selecione + Add e depois Add custom connector (adicionar conector personalizado).2 Digite Chaterimo como nome, cole a URL e selecione Continue. O Claude detecta que o Chaterimo usa um login; mantenha as configurações detectadas, selecione Continue e depois Add.
No Claude Team e Enterprise, um proprietário adiciona o conector para toda a organização em Organization settings → Connectors (Add → Custom → Web). Depois, cada membro seleciona Connect no conector, em Customize → Connectors.2
4Entre e autorize o acesso
O Claude abre o Chaterimo no seu navegador. Entre com a sua conta do Chaterimo. A página Autorizar conector mostra o tipo de conector (MCP somente leitura ou MCP com acesso total) e o Acesso solicitado. Se você é proprietário de várias organizações, escolha uma em Organização; o conector vê apenas essa organização. Selecione Autorizar conector.
O Claude então recebe um token de acesso. Você nunca o vê e nunca o copia. O token vale por uma hora, e o Claude o renova em segundo plano por até 30 dias; depois disso, você entra de novo.
5Ative o conector em um chat e pergunte
Em um chat do Claude, selecione + no canto inferior esquerdo, depois Connectors, e ative o Chaterimo para a conversa.2 Depois, pergunte com palavras simples, por exemplo:
- “Mostre as últimas 5 conversas do Chaterimo.”
- “Como o meu chatbot está se saindo esta semana?”
- “Há tickets de atendimento abertos?”
- “Liste os leads captados esta semana.”
- “Resuma as perguntas sobre entrega dos últimos 7 dias e diga o que falta na minha base de conhecimento.”
O Claude escolhe as ferramentas sozinho. Uma pergunta pode precisar de várias chamadas de ferramentas, por exemplo uma lista de conversas e depois cada conversa.
Claude Code e outros clientes MCP
O Claude Code adiciona um servidor MCP remoto com um único comando e faz o login com o comando /mcp.3
bash
claude mcp add --transport http chaterimo https://www.chaterimo.com/mcp-readonly
Depois, execute /mcp no Claude Code, escolha o Chaterimo e conclua o login no navegador como no passo 4. O Chaterimo registra o Claude Code como cliente OAuth automaticamente, então você não precisa de client ID nem de secret.3
Clientes MCP sem OAuth usam, em vez disso, uma URL com token. Crie uma chave em API para Desenvolvedores → Criar chave de API, marque os Escopos que o cliente pode usar e selecione Criar Chave. A seção URLs legadas com token — para clientes sem suporte a OAuth mostra então uma URL somente leitura e uma URL com acesso completo para a chave. As ferramentas de uma URL com token seguem os escopos da chave.
Atenção
Uma URL com token funciona sem login, então qualquer pessoa que a tenha pode ler os seus dados. Trate-a como uma senha: nunca a compartilhe e nunca a envie para um repositório (no Claude Code, não a adicione com --scope project, que a grava no arquivo compartilhado .mcp.json). Se uma URL vazar, selecione Revogar na chave dela, na página API para Desenvolvedores.
Limites
Cada chamada de ferramenta conta como uma chamada. Os limites valem por organização e são compartilhados por todos os conectores e chaves de API dela (página do MCP do Chaterimo, outubro de 2026):
| Plano | Chamadas por minuto | Chamadas por dia |
|---|---|---|
| Sem plano ativo | 5 | 5 |
| Teste grátis | 10 | 100 |
| Plano pago | 30 | 1.000 |
A contagem diária recomeça à meia-noite no horário de Praga. O seu uso atual aparece em API para Desenvolvedores → Uso do MCP & Limites (Usado hoje).
Como verificar se funciona
- Em um chat novo do Claude com o conector ativado, pergunte “Liste os meus chatbots.” O Claude chama
list_chatbotse responde com os nomes dos seus chatbots. - No Chaterimo, abra API para Desenvolvedores. Usado hoje em Uso do MCP & Limites aumentou de acordo com o número de chamadas.
- Com um conector somente leitura, peça ao Claude que mude a mensagem de boas-vindas. Ele não consegue: o conector somente leitura não oferece ferramentas de escrita.
Solução de problemas
- O Claude mostra “Couldn't connect”
- Remova o conector no Claude e adicione-o de novo. Se ainda falhar, adicione-o mais uma vez e, em OAuth client, escolha Use your own OAuth client. Digite qualquer texto como client ID, por exemplo
chaterimo, deixe o secret vazio e entre normalmente. Se a sua caixa de diálogo mostrar Advanced settings, informe o client ID ali.4 - “Limite diário do MCP atingido para esta organização.”
- A organização já usou as chamadas de hoje. Espere até a meia-noite no horário de Praga ou escolha um plano na página de preços para ter um limite maior.
- “Limite por minuto do MCP atingido para esta organização.”
- Chamadas demais em um minuto. Espere um minuto e pergunte de novo.
- “Este conector é somente leitura e não expõe ferramentas de escrita.”
- Você conectou a URL somente leitura. Adicione um segundo conector com a URL de acesso total se você quiser que o Claude mude o chatbot.
- O Claude não vê as ferramentas da base de conhecimento
- O conector foi adicionado antes de as ferramentas da base de conhecimento existirem. Remova-o, adicione-o de novo e aprove o acesso à base de conhecimento na página Autorizar conector.
- O Claude mostra dados de outra organização
- O conector pertence à organização que você escolheu ao entrar. Remova-o, adicione-o de novo e escolha a organização certa.
- “Invalid or revoked MCP token”
- A chave da URL com token foi revogada. Crie uma chave nova e use a URL dela.
Próximo passo
Peça ao Claude que leia as conversas da última semana e liste as perguntas que o seu chatbot não respondeu bem. Adicione os fatos que faltam à base de conhecimento e depois compare modelos com as mesmas perguntas usando o nosso guia para escolher um LLM para atendimento ao cliente. A nossa pesquisa sobre atendimento ao cliente com IA no e-commerce mostra o que os compradores perguntam e quando.
-
Model Context Protocol, “What is the Model Context Protocol (MCP)?”, acesso em 19 de outubro de 2026, https://modelcontextprotocol.io/docs/getting-started/intro ↑
-
Anthropic, “Get started with custom connectors using remote MCP”, acesso em 19 de outubro de 2026, https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp ↑↑↑
-
Anthropic, “Connect Claude Code to tools via MCP”, acesso em 19 de outubro de 2026, https://code.claude.com/docs/en/mcp ↑↑
-
Anthropic, “Add a connector that isn't in the directory”, acesso em 20 de outubro de 2026, https://claude.com/docs/connectors/custom/add-unlisted ↑
Perguntas frequentes
Quais planos do Chaterimo podem usar o servidor MCP?
Todos os planos, inclusive o teste grátis. O plano define o limite, que é de 100 chamadas por dia no teste e 1.000 por dia em um plano pago.
O Claude pode mudar o meu chatbot pelo MCP?
Só pela URL de acesso total. Com ela, o Claude pode reescrever as instruções, trocar o modelo de IA e o idioma, mudar a janela de chat e os textos dela, editar entradas de texto da base de conhecimento e iniciar um novo treinamento. A URL somente leitura não muda nada.
O Claude vê os endereços de e-mail dos meus clientes?
Sim, onde o Chaterimo os guarda. Leads e tickets incluem dados de contato, e as conversas contêm o que os clientes escreveram. O Claude processa esses dados conforme os termos da sua conta do Claude, então conecte uma conta do Claude que a sua empresa aprove para dados de clientes.
O que o Chaterimo registra sobre as chamadas?
Para cada chamada, o nome da ferramenta, o horário, quanto tempo levou, se falhou, os nomes e tamanhos dos argumentos e o tamanho da resposta; para cada dia, o endereço IP e o cliente da conexão. O Chaterimo não guarda o conteúdo que o Claude lê ou envia.
Preciso de uma chave de API do Chaterimo para o Claude?
Não. O Claude entra com a sua conta do Chaterimo (OAuth). Chaves de API e URLs com token servem apenas para clientes sem suporte a OAuth.
Guia · Primeiro chatbot de IA
Como começar: seu primeiro chatbot de IA em 4 passos
Cadastre-se, conecte sua loja ou adicione seu conteúdo, escolha o modelo de IA e coloque a janela de chat no seu site. O guia inicial para lojas virtuais.
Guia · Chave de API da Anthropic
Anthropic Console: chave de API do Claude para o Chaterimo
Cadastre-se no Anthropic Console (agora Claude Console), compre créditos, crie uma chave de API do Claude e use-a no Chaterimo como chave própria (BYOK).
Pesquisa · Atendimento ao cliente com IA
O estado do atendimento ao cliente com IA no e-commerce 2026
1,09 milhão de mensagens de até 95 lojas virtuais (fevereiro a maio de 2026): quanto a IA atende, quando os clientes escrevem e que modelos as lojas usam.
Histórico de alterações
- Reescrito conforme as configurações atuais de conectores do Claude e as 24 ferramentas do servidor, e transferido para o novo blog.
- Publicado.
