> O servidor MCP do conecta/ai deixa um assistente de IA consultar a organização e preparar alterações para revisão, com o login e as permissões de quem usa. # 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](https://help.conectaai.io/configuracoes/integracoes/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. > **Nota.** > Só se conectam os assistentes que o conecta/ai habilitou. Para conectar outro cliente MCP, escreva para [suporte@conectaai.io](mailto: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`.