> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/primeiros-passos/conectar-patagonai-mcp.md). # Conecte a Patagon AI ao seu assistente de IA O Patagon AI MCP permite que um assistente de IA consulte com segurança as informações da Patagon AI às quais você já tem acesso. Você pode perguntar sobre leads, conversas, agentes, desempenho e relatórios usando uma linguagem simples. ## Antes de começar Você precisa de: * Uma conta ativa na Patagon AI. * Acesso a pelo menos uma organização na Patagon AI. * O endereço MCP da Patagon AI: ``` https://api.patagon.ai/mcp ``` Quando for solicitado que você faça login, use suas credenciais habituais da Patagon AI. Você não precisa de uma chave de API nem de um token de acesso. > O Patagon AI MCP segue as mesmas regras de acesso do aplicativo da Patagon AI. Você verá apenas as organizações e informações permitidas pela sua função. Se, no aplicativo, seu acesso estiver limitado aos leads ou às conversas atribuídos a você, o mesmo limite será aplicado aqui. Os dados de contato protegidos permanecerão ocultos até estarem disponíveis para você na Patagon AI. ## ChatGPT Primeiro, os administradores do workspace do ChatGPT precisam disponibilizar a Patagon AI como um aplicativo personalizado. Se você não encontrar as opções abaixo, peça ao administrador do ChatGPT que siga estas etapas. ### Adicionar a Patagon AI ao workspace 1. Abra o **ChatGPT** no navegador. 2. Abra **Workspace settings**. 3. Acesse **Apps** e selecione **Create**. 4. Se solicitado, ative o **Developer mode**. 5. Dê ao aplicativo o nome `Patagon AI`. 6. Insira `https://api.patagon.ai/mcp` como o endereço do servidor MCP. 7. Escolha a autenticação **OAuth**. 8. Selecione **Scan tools** e conclua o login da Patagon AI na janela que será aberta. 9. Quando a verificação terminar, selecione **Create**. 10. Publique ou habilite o aplicativo para as pessoas que devem usá-lo. ### Conectar-se como membro do workspace 1. Abra **Settings → Apps**. 2. Encontre **Patagon AI** e selecione **Connect**. 3. Faça login na Patagon AI e aprove a conexão. 4. Inicie um novo chat. Selecione **+ → More** e habilite **Patagon AI**. Você também pode mencionar `@Patagon AI` no prompt, caso apareça na lista de aplicativos. ## Aplicativo Codex 1. Abra o **aplicativo Codex**. 2. Abra **Settings → MCP servers**. 3. Selecione **Add server**. 4. Insira `Patagon AI` como nome. 5. Escolha **Streamable HTTP**. 6. Insira `https://api.patagon.ai/mcp` como o endereço do servidor e salve. 7. Selecione **Restart** quando solicitado. 8. Volte para **Settings → MCP servers** e selecione **Authenticate** ao lado de Patagon AI. 9. Faça login na Patagon AI e aprove a conexão. Você pode digitar `/mcp` em uma conversa do Codex para confirmar que a Patagon AI está conectada. ### Alternativa pelo terminal do Codex Se você usa o Codex pelo terminal, copie e execute estes comandos: ```bash codex mcp add patagonai --url https://api.patagon.ai/mcp codex mcp login patagonai ``` Conclua o login da Patagon AI no navegador e, em seguida, inicie uma nova conversa no Codex. ## Claude Code O Claude Code é executado em um terminal, mas a configuração exige apenas um comando. 1. Copie e execute: ```bash claude mcp add --transport http --scope user patagonai https://api.patagon.ai/mcp ``` 2. Abra o Claude Code executando `claude`. 3. Digite `/mcp`. 4. Selecione **Patagon AI** e escolha a opção de autenticação. 5. Faça login na Patagon AI na janela do navegador e aprove a conexão. Após a configuração, a Patagon AI estará disponível nas suas conversas do Claude Code nesse computador. ## Claude Cowork ### Planos pessoais do Claude 1. Abra o Claude e acesse **Customize → Connectors**. 2. Selecione **+** e, em seguida, **Add custom connector**. 3. Dê a ele o nome `Patagon AI`. 4. Insira `https://api.patagon.ai/mcp` como o endereço do servidor MCP remoto. 5. Selecione **Add**, faça login na Patagon AI e aprove a conexão. 6. Abra o Cowork. Use o botão **+**, selecione **Connectors** e habilite **Patagon AI** para a sua conversa. ### Planos Claude Team ou Enterprise Primeiro, um Owner precisa adicionar a Patagon AI para a organização: 1. Acesse **Organization settings → Connectors**. 2. Selecione **Add**. 3. Passe o cursor sobre **Custom** e selecione **Web**. 4. Insira `https://api.patagon.ai/mcp` e selecione **Add**. Em seguida, cada membro pode acessar **Customize → Connectors**, encontrar **Patagon AI**, selecionar **Connect** e concluir o login da Patagon AI. No Cowork, habilite-a para uma conversa em **+ → Connectors**. ## Exemplos simples para começar Comece com um destes prompts: * `A quais organizações da Patagon AI eu tenho acesso?` * `Mostre os leads atribuídos a mim que precisam de atenção.` * `Resuma a conversa mais recente com este lead.` * `Como está o desempenho dos meus agentes? Explique de forma simples.` * `Crie um resumo breve desta semana para o gerente de vendas.` * `Crie um resumo simples do desempenho de marketing.` Se você fizer parte de mais de uma organização, inclua o nome da organização na sua solicitação. Você também pode pedir ao assistente que mostre primeiro as suas organizações. ## Se a conexão não funcionar * **A Patagon AI não aparece:** Confirme se o conector está habilitado para o chat ou a tarefa atual do Cowork. * **Você não consegue adicionar o conector:** Talvez o administrador do seu workspace do ChatGPT ou Claude precise habilitar aplicativos ou conectores personalizados. * **A janela de login não abriu:** Volte para as configurações de MCP ou de conectores e selecione **Authenticate** ou **Connect** novamente. * **O navegador mostra um erro de callback:** Volte para o assistente de IA. Talvez o login já tenha sido concluído; caso contrário, tente se autenticar novamente. * **Há informações ausentes:** Verifique se você consegue visualizar a mesma organização, o mesmo lead ou a mesma conversa no aplicativo da Patagon AI. O MCP usa as mesmas permissões. * **Os dados de contato estão ocultos:** Isso é esperado quando as regras de proteção de contatos da Patagon AI são aplicadas. Para se desconectar, remova a Patagon AI das configurações de MCP ou de conectores do assistente. Você pode se reconectar a qualquer momento usando o mesmo endereço. ## Referências oficiais de configuração * [Aplicativos no ChatGPT](https://help.openai.com/en/articles/11487775-connectors-in) * [Modo de desenvolvedor e aplicativos MCP no ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta) * [MCP no Codex](https://learn.chatgpt.com/docs/extend/mcp) * [MCP no Claude Code](https://code.claude.com/docs/en/mcp) * [Conectores personalizados no Claude e no Cowork](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.patagon.ai/primeiros-passos/conectar-patagonai-mcp.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.