Servidor MCP

O servidor MCP do Zaplin deixa um assistente de IA ler e agir no workspace (contatos, conversas, pipelines, campanhas, automações e o resto) com o seu papel. Ele está disponível em todos os planos. Cada ferramenta é a mesma operação de uma rota da API REST, com o mesmo nome (list_contacts é GET /v1/contacts), o mesmo escopo e as mesmas regras.

https://app.zaplin.com.br/api/mcp

O transporte é o Streamable HTTP do MCP, sem estado: cada requisição é um POST com respostas em JSON.

Conectar um assistenteCopiar link

Autorização (OAuth)Copiar link

O servidor usa OAuth 2.1 com registro dinâmico de cliente, como o MCP pede, então não há chave para copiar:

1. O assistente chama o servidor sem token e recebe 401 com o endereço dos metadados do recurso (/.well-known/oauth-protected-resource/api/mcp), que aponta o servidor de autorização.
2. Ele se registra por registro dinâmico e abre a autorização do Zaplin (metadados em /.well-known/oauth-authorization-server/api/auth).
3. O navegador abre a tela Autorizar {cliente}?. Você escolhe o workspace e clica em Autorizar.
4. O assistente recebe um token para o recurso https://app.zaplin.com.br/api/mcp, que vale para aquele workspace. O access token vale 10 minutos; com offline_access, o assistente o renova sozinho.

A autorização vale para um workspace e para você:

• O assistente age como você, com o seu papel e o seu alcance no workspace. Um Agent que só vê as conversas atribuídas a ele dá ao assistente exatamente isso. Quem é Viewer, ou está sem assento, não pode autorizar.
• Um cliente que pede escopos da API (como contacts:read) fica limitado a eles, além do seu papel. Um assistente que não pede escopos alcança tudo o que o seu papel permite.
• O que o assistente faz aparece na auditoria em nome do app e seu.

DesconectarCopiar link

Owner e Admin veem cada app autorizado no workspace em Configurações › Desenvolvedores › Apps conectados. Revogar acesso apaga a autorização; o assistente para na próxima chamada.

LimiteCopiar link

Cada conexão (app, pessoa e workspace) faz até 60 chamadas por minuto; acima disso recebe 429.

O que pede confirmaçãoCopiar link

As ferramentas que apagam ou alcançam pessoas de verdade (excluir, cancelar, enviar campanha, ativar automação…) pedem o argumento confirm: true. A descrição delas manda o assistente perguntar a você antes e só passar confirm: true depois do seu sim. A lista de ferramentas mostra quais são.

Nenhuma ferramenta passa por cima do seu papel: o que você não pode fazer no app, o assistente também não faz, com ou sem confirm.