Chatway

npx add-mcp 'https://mcp.chatway.app/mcp'

Visão geral do MCP

O servidor MCP do Chatway permite que um assistente de IA — Claude, ChatGPT, Cursor, Codex, Grok, Muse, ou qualquer outro que fale o Model Context Protocol — trabalhe dentro do seu workspace do Chatway usando linguagem natural.

Conecte o Chatway a um assistente de IA

1. Copie a URL do servidor MCP:

https://mcp.chatway.app/mcp

2. Adicione-a como um servidor MCP remoto no Claude, ChatGPT, Cursor, Codex, ou outro cliente MCP.
3. Entre no Chatway e escolha os widgets, canais e permissões que o assistente pode acessar.

É isso — sem necessidade de colar uma chave de API. Etapas específicas por cliente estão em Conectar clientes.

Teste sua conexão perguntando ao seu assistente:

Liste minhas 5 conversas mais recentes do Chatway.

MCP, webhooks ou a API REST?

O Chatway oferece três formas de conectar um sistema externo, e elas resolvem problemas diferentes.

	MCP	Webhooks	API REST
Direção	Seu assistente → Chatway	Chatway → seu servidor	Seu código → Chatway
O que inicia	Você pergunta ao assistente	Um visitante faz algo	Seu código decide
O que decide o resultado	O modelo	Seu código	Seu código
Você escreve código?	Não	Sim	Sim
Autenticação	OAuth	Segredo assinado	X-API-KEY
Configuração em	Seu cliente MCP	Configurações → Ferramentas de Desenvolvedor → Webhooks	Configurações → Ferramentas de Desenvolvedor → Chaves de API

Escolha MCP quando uma pessoa quiser trabalhar por meio de um assistente sob demanda — triando uma fila, resumindo um tópico, redigindo uma resposta. Não há nada para construir, e o modelo decide quais ferramentas chamar, o que é exatamente o motivo pelo qual ele se adequa a trabalhos abertos e não a regras fixas.

Escolha webhooks quando algo no Chatway deve acionar seu sistema em tempo real, na maioria das vezes para que um agente possa responder aos visitantes automaticamente no momento em que eles escrevem.

Escolha a API REST quando você quiser um comportamento exato e repetível, sem modelo no meio: sincronizando conversas no seu data warehouse, provisionando contatos do seu CRM, scripts de back-office, relatórios agendados ou seu próprio painel. Se uma chamada errada for cara, ou se a mesma entrada deve sempre produzir o mesmo resultado, use a API REST em vez de pedir a um assistente para fazer isso.

Eles se combinam bem. Uma configuração comum usa webhooks para notificar um agente, a API REST para que esse agente responda de forma determinística, e MCP para que a equipe de suporte ainda possa fazer perguntas em linguagem natural na mesma caixa de entrada. Veja a Referência da API na barra lateral para endpoints, e o Quickstart para o loop de receber-uma-mensagem-e-responder.

O que o MCP oferece

Uma vez conectado, seu assistente pode trabalhar na sua caixa de entrada de forma conversacional:

"Quantas conversas ainda estão sem resolução no widget de marketing?"

"Resuma a última conversa com john@example.com e depois responda pedindo o número do pedido."

"Marque todas as conversas de hoje que mencionam reembolsos."

Ele faz isso chamando ferramentas que você autorizou explicitamente. Ele nunca obtém sua senha, e você nunca cola uma chave de API nele.

O endpoint é um servidor MCP HTTP streamable e aceita solicitações POST. Ele é separado da API REST: a API REST autentica com um cabeçalho X-API-KEY, o MCP com OAuth.

Autenticação

Clientes MCP usam OAuth 2.1 com PKCE e solicitam o escopo mcp:use. O Chatway suporta registro dinâmico de clientes, então seu cliente lida com toda a troca e você nunca cria um ID de cliente ou segredo.

1. Seu cliente descobre o servidor de autorização do Chatway a partir do endpoint MCP.
2. Um navegador abre e você entra no Chatway.
3. Você nomeia a conexão, para poder reconhecê-la depois.
4. Você escolhe quais widgets e canais o assistente pode acessar.
5. Você escolhe quais permissões conceder e como agente as respostas são enviadas.
6. O Chatway emite um token de acesso limitado exatamente a essas escolhas e retorna você ao seu cliente.

Cada conexão pertence ao seu workspace de equipe, não a um membro individual. Proprietários e administradores gerenciam essa conexão em IA → IA Externa. Reautorizar o mesmo cliente assistente (por exemplo, Claude ou Cursor) atualiza a conexão da equipe em vez de criar uma segunda.

O que os assistentes podem fazer

Vinte e uma ferramentas estão disponíveis. Cada uma requer uma permissão correspondente, então um assistente só vê as ferramentas que você realmente concedeu.

Grupo	Ferramentas
Ler conversas	list-conversations, get-conversation, list-conversation-messages, search-conversations
Ler pessoas	get-visitor, search-contacts
Ler configurações	search-knowledge-base, view-tags, view-custom-fields, list-agents
Responder e triar	send-message, resolve-conversation, unresolve-conversation, assign-conversation
Anotar	add-note, add-tag, remove-tag
Dados personalizados	add-custom-data, update-custom-data, remove-custom-data
Escalar	handoff-to-human

handoff-to-human usa o mesmo comportamento de transferência que o agente de IA integrado do Chatway, então sua equipe recebe as notificações e o estado da caixa de entrada que já espera.

Para parâmetros, formato de retorno e limites de cada ferramenta, veja a Referência de ferramentas.

Escopo de acesso

Uma conexão só pode alcançar os widgets e canais que você selecionou. Ela não vê nada dos seus outros widgets e nunca pode acessar dados de outra equipe. Ambos são aplicados em cada solicitação, independentemente das permissões que você concedeu.

As permissões também respeitam seu papel no Chatway. Apenas proprietários e administradores podem executar o fluxo OAuth do MCP para conectar ou reconectar um assistente e abrir IA → IA Externa nas Configurações. Membros não têm acesso a esse menu. Permissões de escrita em uma conexão só podem ser concedidas por um proprietário ou administrador.

Segurança em ações em massa e destrutivas

Algumas ações pedem confirmação antes que o Chatway as execute. Em vez de agir imediatamente, o assistente precisa fazer a pergunta a você primeiro, junto com o quanto isso vai afetar:

Esta ação resolverá 100 conversas. Tem certeza?

Confirme e ele prossegue. Sua aprovação dura 5 minutos e está vinculada a essa ação exata, então um assistente não pode reutilizá-la para mais nada.

A confirmação é necessária para resolver, desresolver ou atribuir mais de uma conversa por vez, e para remover uma tag ou dados personalizados.

Limites de taxa

As solicitações MCP são limitadas a 120 solicitações por minuto por conexão. Cada conexão tem seu próprio orçamento, então um assistente ocupado não pode desacelerar suas outras conexões. Acima do limite, o servidor retorna 429 e o assistente deve tentar novamente após uma pausa curta.

Respondendo em tempo real com webhooks

O MCP é sob demanda: o assistente age quando você pede. Se você quiser que seu agente de IA responda aos visitantes automaticamente assim que eles enviarem uma mensagem, use webhooks do Chatway junto com a API REST.

Visitor → Chatway → webhook → your AI agent → Chatway API → visitor

O Chatway envia um evento assinado para seu endpoint, seu agente decide o que dizer e responde por meio da API REST. Junto com a resposta, seu agente pode registrar detalhes opcionais de confiança e modelo, o que é útil para acompanhar o desempenho antes de deixá-lo lidar com tudo.

Você também pode conectar o mesmo agente por meio do MCP para acesso sob demanda ao seu workspace do Chatway — triando a fila, resumindo tópicos ou tomando ações em linguagem natural. O MCP é opcional para o loop em tempo real acima; webhooks e a API REST são suficientes por conta própria.

Treze eventos estão disponíveis, incluindo os que a maioria dos agentes precisa:

Evento	Dispara quando
conversation.created	Um novo chat foi iniciado
message.received	Um visitante enviou uma nova mensagem
conversation.resolved	Uma conversa foi resolvida
agent.assigned	Um agente foi atribuído a uma conversa
contact.form.submitted	Um visitante enviou um formulário de contato ou offline

Seu agente pode então usar a API REST para responder, resolver, desresolver, favoritar, atribuir, anotar, marcar, atualizar dados personalizados ou acionar uma transferência humana — as mesmas ações disponíveis via MCP.

Configure isso em Configurações → Ferramentas de Desenvolvedor → Webhooks e veja Docs de Webhook → Visão geral na barra lateral para a lista completa de eventos, formatos de payload, verificação de assinatura e novas tentativas. O Quickstart percorre o loop de receber-uma-mensagem-e-responder de ponta a ponta.

Próximos passos

• Conectar clientes — configure Claude, ChatGPT, Codex, Cursor, Muse e os demais.
• Referência de ferramentas — cada ferramenta, seus parâmetros e o que ela retorna.
• Permissões e acesso — o que cada permissão desbloqueia.
• Gerenciar conexões — revise, edite e revogue o acesso.

{"<?php $__contextArgs = [];\nif (context()->has($__contextArgs[0])) :\nif (isset($value)) { $__contextPrevious[] = $value; }\n$value = context()->get($__contextArgs[0]); ?>":"https://schema.org","@type":"TechArticle","headline":"Overview","description":"The Chatway MCP server lets an AI assistant — Claude, ChatGPT, Cursor, Codex, Grok, Muse, or anything else that speaks the [Model Context Protocol](https://mode…","url":"https://developers.chatway.app/mcp/guides.mcp_overview","image":"https://chatway.app/wp-content/themes/chatway-theme/assets/images/preview/chatway-v2-preview.webp","author":{"@type":"Organization","name":"Chatway"},"publisher":{"@type":"Organization","name":"Chatway","logo":{"@type":"ImageObject","url":"https://chatway.app/wp-content/themes/chatway-theme/assets/images/preview/chatway-v2-preview.webp"}}}