> ## Documentation Index > Fetch the complete documentation index at: https://help.ciarem.ai/llms.txt > Use this file to discover all available pages before exploring further. # Assistentes de IA (MCP) > Conecte a Ciarem ao Claude, ChatGPT, Cursor ou qualquer assistente compatível com MCP e pergunte sobre suas conversas, contatos, base de conhecimento, métricas e a configuração e o desempenho do seu agente de IA em linguagem natural. Você pode conectar a Ciarem a um assistente de IA como o Claude ou o ChatGPT. Depois de conectado, você pode perguntar coisas como "quais chats estão esperando resposta?" ou "me prepare para a ligação com a Laura", e o assistente lê a resposta do seu espaço de trabalho da Ciarem. A Ciarem se conecta via MCP (Model Context Protocol), um padrão aberto, então funciona em qualquer assistente que aceite servidores MCP remotos. A conexão é **somente leitura**: o assistente pode consultar informações, mas não pode enviar mensagens, editar contatos nem mudar nenhuma configuração. ## Antes de começar * Você precisa de um usuário da Ciarem em um espaço de trabalho com plano ou teste ativo. * Cada pessoa se conecta com o próprio login da Ciarem. O assistente vê o mesmo que essa pessoa vê na Ciarem, nada além disso. * Não é preciso configurar nada na Ciarem. Qualquer membro do espaço de trabalho pode se conectar. O endereço para adicionar no seu assistente é: ``` https://api.ciarem.ai/mcp ``` ## Conectar Ao adicionar o endereço, o assistente abre uma página de login da Ciarem. Entre, escolha o **espaço de trabalho** que deseja conectar se você participa de mais de um e permita o acesso. Cada conexão lê um único espaço de trabalho; para usar dois, adicione a Ciarem duas vezes e escolha um diferente em cada uma. Os menus abaixo são de cada assistente e podem mudar. Se um rótulo não bater, procure "conectores", "apps" ou "servidores MCP" nas configurações dele. **Claude** A Ciarem está no diretório de conectores do Claude como **Ciarem AI**, então você não precisa colar o endereço. **1. Abra o conector Ciarem AI** Abra a [Ciarem AI no diretório do Claude](https://claude.ai/directory/ciarem-ai), ou no Claude (web ou desktop) vá em **Settings > Connectors**, navegue pelos conectores e busque "Ciarem AI". **2. Conecte sua conta** Clique em **Connect**, entre na Ciarem e escolha seu espaço de trabalho. **3. Use em um chat** Ative a Ciarem no menu **+** de uma conversa e faça sua pergunta. Nos planos Team e Enterprise do Claude, um proprietário pode precisar ativar o conector para a organização em **Admin settings > Connectors** antes que os membros possam se conectar. **ChatGPT** A Ciarem está no diretório de apps do ChatGPT, então você não precisa colar o endereço. **1. Abra o app da Ciarem** Abra a [Ciarem no diretório do ChatGPT](https://chatgpt.com/plugins/plugin_asdk_app_6ac028974a38819183e40cf821805610), ou no ChatGPT vá em **Settings > Apps & Connectors**, navegue pelo diretório e busque "Ciarem". **2. Conecte sua conta** Clique em **Connect**, entre na Ciarem e escolha seu espaço de trabalho. **3. Use em um chat** Selecione a Ciarem no menu de ferramentas de uma conversa e faça sua pergunta. Nos planos Business e Enterprise, o administrador do ChatGPT pode precisar liberar o app primeiro. **Claude Code, Cursor, VS Code** No Claude Code, execute: ```bash theme={null} claude mcp add --transport http ciarem https://api.ciarem.ai/mcp ``` Depois digite `/mcp`, escolha **ciarem** e entre. No Cursor (`~/.cursor/mcp.json`) ou no VS Code (`.vscode/mcp.json`), adicione o servidor e inicie-o; o editor abre o login da Ciarem no primeiro uso: ```json theme={null} { "servers": { "ciarem": { "type": "http", "url": "https://api.ciarem.ai/mcp" } } } ``` O Cursor usa `mcpServers` em vez de `servers` como chave principal. **Outros assistentes** Qualquer assistente que aceite **servidores MCP remotos com OAuth** pode se conectar. Adicione um servidor MCP remoto (HTTP) com o endereço acima e sem chave de API. O assistente se registra sozinho e leva você à página de login da Ciarem. ## O que você pode perguntar | O assistente pode | Quem | | - | - | | Dizer com qual usuário e espaço de trabalho da Ciarem está conectado | Todos | | Buscar contatos por nome, telefone ou e-mail, opcionalmente por etapa do funil ou só os seus, e abrir um contato com as últimas conversas | Todos | | Listar conversas do inbox por status, canal, atribuídas a você ou sem atribuição, e ler uma conversa, incluindo as notas internas | Todos | | Buscar nas suas [bases de conhecimento](https://help.ciarem.ai/pt/ai-agent/knowledge-bases.md) do mesmo jeito que seu agente de IA, ou encontrar onde aparece uma frase exata | Todos | | Consultar os passos desta central de ajuda, em português, inglês ou espanhol | Todos | | Informar métricas de conversas e da equipe das últimas 24 horas ou 7 dias | Administradores | | Verificar se seu agente de IA está pronto e o que corrigir, além do status de cada canal | Administradores | | Explicar por que o agente de IA respondeu, transferiu ou recusou nas conversas recentes de um contato | Administradores | | Mostrar como seu agente de IA está configurado: perfil do negócio, tom e demais ajustes, a função e as perguntas de cada agente, o coaching e as [regras de transferência](https://help.ciarem.ai/pt/ai-agent/human-handoff-and-escalation.md) | Administradores | | Informar como o agente de IA se saiu nas últimas 24 horas, 7 dias ou 30 dias: quanto atendeu ou transferiu, erros, tempo de resposta e as regras de transferência que mais dispararam | Administradores | | Listar suas fontes de conhecimento, ler uma completa e listar as perguntas dos clientes que seu conhecimento não conseguiu responder | Administradores | | Resumir suas [avaliações de respostas](https://help.ciarem.ai/pt/ai-agent/evaluation-center.md): o veredito de cada categoria, a correção aplicada e respostas de exemplo | Administradores | Algumas perguntas para testar: * "Quais conversas atribuídas a mim estão esperando resposta? Resuma cada uma em uma linha." * "Me prepare para a ligação com a Laura Gómez: etapa do funil, propriedades e sobre o que falamos da última vez." * "O que nossa base de conhecimento diz sobre reembolsos?" * "Me dê um relatório semanal: conversas, quantas a IA atendeu e o ranking da equipe." * "Por que a IA transferiu a última conversa com +55 11 91234 5678?" * "O que devo melhorar no meu agente de IA?" * "De qual fonte a IA tira que o frete custa R\$ 5?" Cada resposta traz links para a Ciarem, para você abrir o contato ou a conversa e responder por lá. ## Quem vê o quê O assistente usa a [função](https://help.ciarem.ai/pt/using-ciarem/roles-and-permissions.md) da pessoa que o conectou: * **Agentes** veem só os próprios contatos e as conversas que podem ver no inbox. As perguntas exclusivas de administradores respondem que é preciso um administrador. * **Administradores** veem todo o espaço de trabalho. A Ciarem verifica seu acesso a cada pergunta. Se você for removido do espaço de trabalho ou sua função mudar, a conexão reflete isso na hora. O que você pergunta, e os dados da Ciarem que o assistente lê para responder, são enviados ao provedor desse assistente (por exemplo, Anthropic ou OpenAI) e tratados conforme os termos dele. Conecte apenas assistentes que sua empresa permite usar com dados de clientes. ## Desconectar Remova ou desconecte a Ciarem nas configurações de conectores ou apps do assistente. Remover uma pessoa do espaço de trabalho também encerra todas as conexões que ela fez. ## Solução de problemas * **"subscription\_required"**: o espaço de trabalho não tem plano nem teste ativo. Veja [Planos e cobrança](https://help.ciarem.ai/pt/billing/plans-and-billing.md). * **"requires\_admin"**: a pergunta precisa de um administrador; agentes não podem ver métricas, a saúde da conta, as explicações das decisões da IA nem a configuração, o desempenho, as fontes de conhecimento, as perguntas sem resposta e as avaliações do agente de IA. * **"help\_unavailable"**: não foi possível consultar a central de ajuda; pergunte de novo em instantes. * **O login se repete ou aparece "invalid token" logo depois de conectar**: desconecte, conecte de novo e escolha um espaço de trabalho na página de login da Ciarem. * **Não encontra um contato ou uma conversa**: seu usuário também não o vê na Ciarem, ou ele pertence a outro espaço de trabalho, diferente do que você conectou. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.