Servidor MCP de Jornadas
O Turn expõe as ferramentas que o Ripple, o copiloto de IA do construtor de jornadas, usa para construir jornadas como um servidor Model Context Protocol, para que você possa construir, corrigir e testar jornadas a partir do seu próprio agente de IA, como o Claude Code, e testá-las com suas próprias ferramentas através da API de Simulação de Jornadas.
Este servidor está em desenvolvimento ativo e suas ferramentas podem mudar.
Conectando
O servidor fica em https://whatsapp.turn.io/v1/mcp e usa a mesma autenticação de todas as outras chamadas de API: um token do Turn.io do número, enviado no cabeçalho Authorization. Todas as ferramentas trabalham com as jornadas desse número.
Para conectar o Claude Code:
$ claude mcp add --transport http turn https://whatsapp.turn.io/v1/mcp \
--header "Authorization: Bearer token"
Qualquer cliente MCP que suporte o transporte Streamable HTTP e cabeçalhos personalizados pode se conectar da mesma forma.
Ferramentas
| Ferramenta | O que faz |
|---|---|
GetAuthoringGuide | Como escrever jornadas, em partes: overview (regras para o texto dos cards, agentes de IA ou fluxos fixos, as ferramentas de código, o básico da DSL), cards (todos os tipos de card), expressions (variáveis, lógica, funções), example (uma jornada completa), number (os campos de contato, modelos de IA e idiomas do número), skills e templates (as skills e os templates de WhatsApp do número). Uma parte longa demais para um resultado vem em páginas. |
ListJourneys, GetJourney, CreateJourney | Encontrar, ler e criar jornadas. Todo resultado inclui a URL do canvas da jornada. |
ReplaceAllCode, EditJourney | Escrever uma jornada inteira ou alterar alguns de seus cards. O código é validado primeiro: quando não é válido, nada é salvo e o resultado diz o que corrigir. |
GetTranslations, UpdateTranslations | Ler e escrever as traduções da jornada. |
RenameJourney | Renomear uma jornada. |
GetSkills, CreateSkill, UpdateSkill, DeleteSkill | Gerenciar as skills dos agentes de IA do número. |
CreateContactField | Adicionar um campo de contato ao número. |
ListSecrets, GetTemplate, GetJourneyExample | Consultar os segredos do número (só os nomes), os templates do WhatsApp e os exemplos de jornada. |
Simulate | Jogar um turno de uma conversa simulada com uma jornada. Recebe e retorna os mesmos campos da API de Simulação de Jornadas. |
Quando o número tem testes de jornada, WriteTests, EditTests e RunTests também são oferecidas.
Construindo e testando uma jornada
Quando um agente se conecta, o servidor diz como trabalhar:
- Ler o guia de criação (pelo menos
overview,cardsenumber). - Criar a jornada e escrevê-la com
ReplaceAllCode, depois alterá-la comEditJourney, corrigindo o que a validação apontar. - Abrir a URL do canvas para mostrar o que foi construído. Recarregar a página depois de uma edição para ver a mudança.
- Testá-la com
Simulate. - Escrever uma suíte de testes contra a API de Simulação de Jornadas com o mesmo token, rodá-la e editar a jornada via MCP até ela passar.
Observações
- Cada edição é salva como uma nova revisão não publicada da jornada, identificada como feita via MCP.
Simulateusa a última revisão salva, a menos que se peçaproduction. Publique pelo canvas quando estiver satisfeito. - Mudanças em campos de contato e em skills compartilhadas com outras jornadas afetam todas as jornadas do número, então um agente deve pedir sua confirmação antes de fazê-las.