# Servidor MCP do Chaterimo: conecte o Claude ao seu chatbot

- URL: https://www.chaterimo.com/pt-br/blog/chaterimo-mcp-servidor-claude-integracao/
- Language: pt-br
- Type: Guia
- Author: David Langr
- Published: 2026-05-04
- Updated: 2026-10-20

> 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.

## Principais conclusões

- O 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.
- Você 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.
- A 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.
- As 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.
- O 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 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

### 1. Escolha 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.

### 2. Copie 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.

### 3. Adicione 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]

### 4. Entre 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.

### 5. Ative 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.

> **Warning**
>
> 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](https://www.chaterimo.com/pt-br/mcp/), 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

1. Em um chat novo do Claude com o conector ativado, pergunte “Liste os meus chatbots.” O Claude chama `list_chatbots` e responde com os nomes dos seus chatbots.
2. No Chaterimo, abra **API para Desenvolvedores**. **Usado hoje** em **Uso do MCP & Limites** aumentou de acordo com o número de chamadas.
3. 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](https://www.chaterimo.com/pt-br/precos/) 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](https://www.chaterimo.com/pt-br/blog/como-escolher-llm-para-atendimento-ao-cliente/). A nossa [pesquisa sobre atendimento ao cliente com IA no e-commerce](https://www.chaterimo.com/pt-br/blog/estado-do-atendimento-ao-cliente-com-ia/) mostra o que os compradores perguntam e quando.

**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.


[^1]: Model Context Protocol, “What is the Model Context Protocol (MCP)?”, acesso em 19 de outubro de 2026, https://modelcontextprotocol.io/docs/getting-started/intro
[^2]: 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
[^3]: Anthropic, “Connect Claude Code to tools via MCP”, acesso em 19 de outubro de 2026, https://code.claude.com/docs/en/mcp
[^4]: 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