Servidor MCP
O servidor MCP (Model Context Protocol) deixa um assistente de IA consultar a sua organização e preparar alterações para alguém revisar. É uma forma de integrar diferente da API REST:
| API REST | Servidor MCP | |
|---|---|---|
| Para quem | Um script ou servidor seu | Um assistente de IA |
| Como autentica | Chave de API da organização | Login da própria pessoa, por OAuth |
| O que enxerga | O que as permissões da chave liberam | O que a pessoa conectada pode fazer no produto |
O passo a passo de quem usa o assistente está na Central de Ajuda, em Conexões com assistentes. Esta página é para quem integra.
Endereço e autorização
| Item | Valor |
|---|---|
| Endereço do servidor | https://app.conectaai.io/api/mcp |
| Descoberta do recurso | https://app.conectaai.io/.well-known/oauth-protected-resource |
| Descoberta da autorização | https://app.conectaai.io/.well-known/oauth-authorization-server |
| Fluxo | OAuth 2.1 com código de autorização e PKCE (S256) |
| Escopos | conectaai:read (consultas) e conectaai:write (preparar alterações) |
O acesso vale por 15 minutos e é renovado pelo assistente com o token de renovação, que vale 30 dias. A pessoa revoga a conexão a qualquer momento em Conexões com assistentes, no menu da conta.
Só se conectam os assistentes que o conecta/ai habilitou. Para conectar outro cliente MCP, escreva para suporte@conectaai.io.
Ferramentas
O assistente vê só as ferramentas que a pessoa conectada pode usar. A coluna Permissão é a do produto.
| Ferramenta | O que faz | Permissão |
|---|---|---|
connection_context | Diz qual empresa e qual acesso estão conectados | nenhuma |
search_product_help | Busca na Central de Ajuda, com as fontes | nenhuma, funciona sem login |
list_agents | Lista os agentes da empresa | agentes:view |
get_agent | Lê a configuração de um agente pelo ID | agentes:view |
list_channels | Lista os canais, sem credenciais | integracoes:view |
get_operation_metrics | Indicadores da operação num período de até 90 dias | dashboard:view |
list_interactions | Histórico de atendimentos por período, paginado | historico:view |
get_interaction | Lê um atendimento e a transcrição | historico:view |
list_knowledge_bases | Lista as bases de conhecimento, inclusive as vazias | conhecimento:view |
search_knowledge | Busca no conhecimento da empresa | conhecimento:view |
prepare_agent_update | Prepara uma alteração de agente para revisão, sem aplicar | agentes:edit |
prepare_knowledge_change | Prepara a criação ou edição de conhecimento, sem aplicar | conhecimento:create ou conhecimento:edit |
get_change_status | Consulta o resultado de uma proposta da própria pessoa | nenhuma |
As ferramentas que preparam alterações também exigem o escopo conectaai:write. Nenhuma delas aplica a mudança: ela gera uma proposta com link, e a alteração só acontece quando alguém clica em Confirmar alteração dentro do conecta/ai.
Limite
São até 120 chamadas por minuto, contadas por pessoa, por organização e por assistente conectado. Acima disso a resposta é 429, com Retry-After: 60.