> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Conector Claude & ChatGPT (MCP)

> Crie e execute seus agentes telefônicos de IA diretamente do Claude ou ChatGPT — através de uma conexão OAuth segura e única.

O conector da Sua SofIA permite que você **construa e opere seus agentes telefônicos de IA diretamente do Claude ou ChatGPT**. Em vez de clicar pelo painel, você apenas descreve o que deseja — e seu assistente de IA faz isso na sua conta:

* *"Crie uma recepcionista de entrada que agende compromissos."*
* *"Mostre-me por que minha última chamada de campanha falhou."*
* *"Adicione três leads à minha campanha de acompanhamento e inicie-a."*

<Note>
  É um **servidor MCP remoto** protegido por **OAuth 2.0**. Você se conecta uma vez, faz login para aprovar e cada ação permanece restrita à **sua própria conta da Sua SofIA** — o conector só vê e altera seus dados.
</Note>

## O que você pode fazer

<CardGroup cols={2}>
  <Card title="Construir e refinar assistentes" icon="robot" href="/ai-assistants/settings/general" color="#06df4b">
    Entrada e saída: prompt do sistema, voz, idioma, modelo e comportamento da chamada. Anexe
    bases de conhecimento (seus documentos) e ferramentas de chamada (consultas de API ao vivo durante uma chamada).
  </Card>

  <Card title="Executar campanhas de saída" icon="bullhorn" href="/campaigns/index" color="#06df4b">
    Crie campanhas, adicione e gerencie leads, e inicie, pause ou retome-as.
  </Card>

  <Card title="Revisar e melhorar" icon="magnifying-glass-chart" href="/outbound-calls/overview" color="#06df4b">
    Liste chamadas, leia transcrições completas e avaliações pós-chamada, depois atualize o assistente ou suas
    ferramentas — um ciclo completo de construção → revisão → melhoria.
  </Card>

  <Card title="Gerenciar sua conta" icon="gear" href="/api-reference/introduction" color="#06df4b">
    Bases de conhecimento e documentos, números de telefone e troncos SIP, remetentes e modelos do WhatsApp,
    conversas, pastas, etiquetas, chaves de API e sua lista negra.
  </Card>
</CardGroup>

Ler e escrever são ferramentas separadas. Ações que **gastam saldo** (realizar uma chamada, enviar SMS/WhatsApp, comprar um número) ou **excluem dados** sempre pedem confirmação primeiro. Segredos de integração (por exemplo, tokens de autenticação em suas ferramentas de chamada) são **mascarados** nas respostas.

## Antes de começar

* Uma **conta da Sua SofIA** em [suasofia.online](https://suasofia.online) — ou o domínio do seu provedor de marca branca.
* Um **plano ativo** para os recursos que você usa (algumas ações consomem minutos de chamada ou créditos de chat).

### Seu link de conexão

Este é o endereço seguro que Claude e ChatGPT usam para acessar sua conta. Copie-o — você o colará durante a configuração e, em seguida, fará login para aprovar.

```
https://suasofia.online/mcp
```

<Info>
  **Clientes de marca branca:** use **o domínio do seu provedor** em vez disso — `https://{seu-dominio}/mcp`.
  A marca segue o domínio, então você só verá a marca do seu provedor.
</Info>

## Adicionar o conector

<Tabs>
  <Tab title="Claude">
    <Steps>
      <Step title="Abrir Personalizar">
        No Claude, abra a barra lateral esquerda e clique em **Personalizar**.

        <Frame>
          <img src="https://mintcdn.com/sofia-00a9d19b/AAG3ujb6Qbi6wYh_/resources/mcp/claude-1.png?fit=max&auto=format&n=AAG3ujb6Qbi6wYh_&q=85&s=62453df021ef68a5b9180c58dbad5c05" alt="Abra o painel Personalizar no Claude" width="354" height="248" data-path="resources/mcp/claude-1.png" />
        </Frame>
      </Step>

      <Step title="Abrir Conectores">
        No painel Personalizar, clique em **Conectores**.

        <Frame>
          <img src="https://mintcdn.com/sofia-00a9d19b/AAG3ujb6Qbi6wYh_/resources/mcp/claude-2.png?fit=max&auto=format&n=AAG3ujb6Qbi6wYh_&q=85&s=7190ee4fe4def830065f307e520b3d33" alt="Abra Conectores no painel Personalizar do Claude" width="288" height="269" data-path="resources/mcp/claude-2.png" />
        </Frame>
      </Step>

      <Step title="Adicionar um conector personalizado">
        Clique no botão **+** no canto superior direito do painel Conectores, depois escolha **Adicionar conector
        personalizado**.

        <Frame>
          <img src="https://mintcdn.com/sofia-00a9d19b/AAG3ujb6Qbi6wYh_/resources/mcp/claude-3.png?fit=max&auto=format&n=AAG3ujb6Qbi6wYh_&q=85&s=5d6b73a4986d263dd35c5c4ab14566ac" alt="Adicionar um conector personalizado no Claude" width="654" height="455" data-path="resources/mcp/claude-3.png" />
        </Frame>
      </Step>

      <Step title="Nomeie e cole seu link">
        Digite qualquer nome (por exemplo, *Sua SofIA*), cole seu link de conexão em **URL do servidor MCP remoto**,
        deixe os campos OAuth vazios e clique em **Adicionar**.

        <Frame>
          <img src="https://mintcdn.com/sofia-00a9d19b/AAG3ujb6Qbi6wYh_/resources/mcp/claude-4.png?fit=max&auto=format&n=AAG3ujb6Qbi6wYh_&q=85&s=e47baa2712cd44b9ab97bf65384240e3" alt="Cole a URL do MCP da Sua SofIA no Claude" width="1132" height="1088" data-path="resources/mcp/claude-4.png" />
        </Frame>
      </Step>

      <Step title="Faça login e aprove">
        Faça login na sua conta da Sua SofIA e aprove. Suas ferramentas aparecerão na lista — você está
        conectado.

        <Frame>
          <img src="https://mintcdn.com/sofia-00a9d19b/AAG3ujb6Qbi6wYh_/resources/mcp/claude-5.png?fit=max&auto=format&n=AAG3ujb6Qbi6wYh_&q=85&s=2454ab0da884e73b7f1cfd6b39f804d9" alt="Faça login e aprove o conector da Sua SofIA no Claude" width="2566" height="1714" data-path="resources/mcp/claude-5.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="ChatGPT">
    <Steps>
      <Step title="Abrir Configurações">
        No ChatGPT, clique no seu nome no canto inferior esquerdo e depois em **Configurações**.

        <Frame>
          <img src="https://mintcdn.com/sofia-00a9d19b/AAG3ujb6Qbi6wYh_/resources/mcp/chatgpt-1.png?fit=max&auto=format&n=AAG3ujb6Qbi6wYh_&q=85&s=90c01bf98e4491b3d0f2528dfb5173c2" alt="Abra Configurações no ChatGPT" width="320" height="428" data-path="resources/mcp/chatgpt-1.png" />
        </Frame>
      </Step>

      <Step title="Ir para Apps → Configurações avançadas">
        Abra a aba **Apps** (conectores agora estão sob "Apps"), depois abra **Configurações avançadas**.

        <Frame>
          <img src="https://mintcdn.com/sofia-00a9d19b/AAG3ujb6Qbi6wYh_/resources/mcp/chatgpt-2.png?fit=max&auto=format&n=AAG3ujb6Qbi6wYh_&q=85&s=f9ed79534e8957b18b331ca7529331b3" alt="Abra Apps e depois Configurações avançadas no ChatGPT" width="928" height="721" data-path="resources/mcp/chatgpt-2.png" />
        </Frame>
      </Step>

      <Step title="Ativar Modo desenvolvedor e depois Criar app">
        Ative o **Modo desenvolvedor** (isso permite que você adicione um conector personalizado), depois clique em **Criar app**
        no topo.

        <Frame>
          <img src="https://mintcdn.com/sofia-00a9d19b/AAG3ujb6Qbi6wYh_/resources/mcp/chatgpt-3.png?fit=max&auto=format&n=AAG3ujb6Qbi6wYh_&q=85&s=fce95cb01aad88baa9637dcd9c2916ea" alt="Ative o Modo desenvolvedor e Crie app no ChatGPT" width="945" height="716" data-path="resources/mcp/chatgpt-3.png" />
        </Frame>
      </Step>

      <Step title="Cole seu link e crie">
        Dê um nome, cole seu link de conexão no campo **URL do servidor**, defina
        **Autenticação** como **OAuth**, marque *"Eu entendo e quero continuar"*, e depois **Criar**.
        Faça login na sua conta da Sua SofIA e aprove.

        <Frame>
          <img src="https://mintcdn.com/sofia-00a9d19b/AAG3ujb6Qbi6wYh_/resources/mcp/chatgpt-4.png?fit=max&auto=format&n=AAG3ujb6Qbi6wYh_&q=85&s=11ed3a0a371bc8f1610fc83fa19ee515" alt="Cole a URL do MCP da Sua SofIA e crie o app no ChatGPT" width="470" height="811" data-path="resources/mcp/chatgpt-4.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Tip>
  Uma vez que o conector esteja listado nos diretórios do Claude e ChatGPT, você também poderá adicioná-lo com
  um clique, pesquisando por **Sua SofIA** em Configurações → Conectores — sem necessidade de URL manual.
</Tip>

## Experimente

Inicie um novo chat no Claude ou ChatGPT e pergunte, por exemplo:

<CardGroup cols={2}>
  <Card title="Construir" icon="wand-magic-sparkles" color="#06df4b">
    "Crie uma recepcionista de entrada para minha clínica dentária que agende compromissos e responda FAQs."
  </Card>

  <Card title="Melhorar" icon="arrow-trend-up" color="#06df4b">
    "Leia minhas últimas 5 chamadas e me diga o que meu assistente errou."
  </Card>

  <Card title="Integrar" icon="plug-circle-bolt" color="#06df4b">
    "Crie uma ferramenta de chamada que busque um pedido por número na nossa API."
  </Card>

  <Card title="Executar" icon="bullhorn" color="#06df4b">
    "Configure uma campanha de saída para os leads desta semana e inicie-a."
  </Card>
</CardGroup>

## Segurança e privacidade

* **OAuth 2.0** com uma tela de consentimento personalizada — nenhuma chave de API é colada no cliente de chat.
* **Restrito à sua conta** — o conector só pode ver e alterar seus próprios dados.
* **Segredos mascarados** — tokens de autenticação armazenados em suas ferramentas nunca são retornados em texto claro.
* **Sem coleta de histórico de chat** — o conector atua apenas nos recursos da Sua SofIA.
* Política de privacidade: [suasofia.com.br/privacy-policy](https://suasofia.com.br/privacy-policy).

## FAQ

<AccordionGroup>
  <Accordion title="Quais aplicativos de IA posso usar com isso?">
    Este guia cobre **Claude** e **ChatGPT**. O conector é um servidor MCP remoto padrão, então também funciona com qualquer outro cliente compatível com MCP (por exemplo, Cursor ou VS Code) — a configuração é a mesma: adicione um conector personalizado e cole seu link de conexão.
  </Accordion>

  <Accordion title="Preciso de uma chave de API?">
    Não. A conexão é gerenciada por **OAuth** — você simplesmente faz login na sua conta da Sua SofIA e aprova.
    Nenhuma chave é colada no aplicativo de chat.
  </Accordion>

  <Accordion title="É seguro conectar?">
    Sim. Cada ferramenta é restrita à sua própria conta autenticada, ações de escrita e destrutivas pedem confirmação, e quaisquer segredos de integração que você armazenou são mascarados nas respostas.
  </Accordion>

  <Accordion title="Isso vai gastar meu saldo?">
    Apenas quando você explicitamente pedir para fazer uma chamada ou enviar um SMS/WhatsApp — e ele confirma primeiro.
    Construir e editar assistentes, ler chamadas e gerenciar sua conta não realizam chamadas.
  </Accordion>

  <Accordion title={`Minha chamada está bloqueada no ChatGPT ("bloqueada por verificações de segurança da OpenAI")`}>
    Este bloqueio vem da **própria camada de segurança da OpenAI dentro do ChatGPT**, não de nós. Quando o ChatGPT está prestes a acionar uma ferramenta que realiza uma chamada telefônica de saída real, a política da OpenAI sobre agentes de IA iniciando chamadas telefônicas impede que isso aconteça antes que a solicitação chegue até nós. Não podemos ignorar a decisão da OpenAI do nosso lado, e isso afeta principalmente o **navegador do ChatGPT**.

    Coisas que funcionam:

    * **Aplicativo de desktop do ChatGPT** ou um **agente da OpenAI** — a mesma chamada passa por lá.
    * **Claude** — a chamada funciona lá também, incluindo a realização de uma chamada de lembrete através do assistente.
    * **Agendar uma campanha de saída** — para chamadas de lembrete ("ligar para John às 16:00"), configure uma
      campanha de saída agendada (assistente + contato + horário) a partir do painel ou via API /
      Automate. Isso nunca passa pela camada de segurança do ChatGPT, então nunca é bloqueado.

    Uma integração nativa do ChatGPT está em revisão com a OpenAI e em breve estará disponível.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.