---
title: "Conecte a Spryx a ferramentas de IA via MCP"
category: "Integrações e Apps"
updatedAt: "2026-10-23T22:15:22Z"
url: "https://spryx.ai/help/integracoes-e-apps/conecte-claude-ou-chatgpt-a-spryx-via-mcp"
---

# Conecte a Spryx a ferramentas de IA via MCP

Use o servidor MCP da Spryx no Claude, ChatGPT ou em outra ferramenta compatível e controle o acesso concedido.

MCP é uma forma segura de permitir que uma ferramenta de IA consulte dados e realize ações na Spryx. O servidor da Spryx pode ser conectado ao Claude, ao ChatGPT e a outros clientes compatíveis com MCP remoto por HTTPS e autorização OAuth.

Este guia usa Claude e ChatGPT nos tutoriais porque são os casos mais comuns. Em outra ferramenta compatível, você usará o mesmo endereço do servidor e passará pela mesma autorização da Spryx.

Por exemplo, você pode perguntar quais tarefas vencem hoje, procurar um contato ou pedir a criação de uma tarefa. O que o assistente consegue fazer depende das permissões que você autorizar e do seu papel no workspace.

**Pré-requisitos**

- **Plano:** A disponibilidade de servidores MCP remotos varia conforme a ferramenta e o plano. No Claude, conectores personalizados estão disponíveis nos planos Pro, Max, Team e Enterprise. No ChatGPT, o acesso depende das regras da conta e do workspace.
- **Permissão:** O administrador do workspace pode desativar apps externos. Mesmo conectado, o assistente nunca ultrapassa as permissões do seu papel na Spryx.
- **Limite:** Cada conexão pertence a uma pessoa e a um workspace. Para acessar outro workspace, faça uma nova conexão.

## O que você vai precisar {#o-que-voce-vai-precisar}

- uma conta ativa na Spryx;
- acesso ao workspace que deseja conectar;
- uma ferramenta compatível com servidores MCP remotos por HTTPS e autorização OAuth;
- o endereço oficial do MCP da Spryx:

`https://api.spryx.ai/mcp`

Copie o endereço exatamente como aparece acima. Você não precisa gerar uma chave de API: a Spryx usa uma autorização pelo navegador para confirmar sua identidade, o workspace e as permissões.

> **Atenção**
>
> **Use somente o endereço oficial.** Um servidor MCP pode acessar dados e realizar ações em seu nome. Conecte apenas o endereço publicado pela Spryx e revise as permissões antes de continuar.

## Conecte em outra ferramenta compatível {#conecte-em-outra-ferramenta-compativel}

Os nomes dos menus mudam entre aplicativos, mas o fluxo de conexão costuma ser o mesmo:

1. Procure a opção para adicionar um servidor MCP remoto, conector personalizado ou integração personalizada.
2. Em **Nome**, informe `Spryx`.
3. Em **URL do servidor**, cole `https://api.spryx.ai/mcp`.
4. Se a ferramenta solicitar o tipo de transporte, escolha **Streamable HTTP** ou **HTTP**.
5. Em **Autenticação**, escolha **OAuth** ou a opção de entrar pelo navegador.
6. Inicie a conexão, escolha o workspace na tela da Spryx e revise as permissões.
7. Ative as ferramentas da Spryx na conversa e faça uma consulta simples para testar.

A ferramenta precisa aceitar servidores MCP remotos e abrir o navegador para a autorização. Clientes que aceitam apenas servidores locais por `stdio` não conseguem usar diretamente este endereço. Consulte a documentação do aplicativo para confirmar a compatibilidade e localizar os campos equivalentes.

## Conecte no Claude {#conecte-no-claude}

As instruções abaixo valem para o Claude na web e para o Claude Desktop.

1. Abra o Claude e entre na sua conta.
2. Abra **Configurações** e depois **Conectores**.
3. Clique em **Adicionar conector personalizado**.
4. Em **Nome**, informe `Spryx`.
5. Em **URL do conector**, cole `https://api.spryx.ai/mcp`.
6. Clique em **Adicionar**.
7. Localize a Spryx na lista e clique em **Conectar**.
8. O navegador abrirá a tela de autorização da Spryx. Entre na conta, se necessário, escolha o workspace e revise as permissões.

Em contas Team ou Enterprise, um Owner ou Primary Owner do Claude precisa primeiro adicionar o conector em **Organization connectors**. Depois disso, cada pessoa conecta sua própria conta da Spryx.

Para usar a conexão em uma conversa, abra **Busca e ferramentas**, habilite **Spryx** e faça um pedido. Depois que o conector é configurado pela web, ele também pode ser usado nos aplicativos móveis compatíveis do Claude.

Consulte também as [instruções oficiais de conectores personalizados do Claude](https://support.anthropic.com/en/articles/11175166-about-custom-integrations-using-remote-mcp).

## Conecte no ChatGPT {#conecte-no-chatgpt}

A configuração de um servidor MCP personalizado é feita no ChatGPT pela web.

1. Abra a área de [Plugins do ChatGPT](https://chatgpt.com/plugins).
2. Clique no botão **+**.
3. Escolha **Add custom MCP server**.
4. Em **Name**, informe `Spryx`. A descrição é opcional.
5. Em **Server URL**, cole `https://api.spryx.ai/mcp`.
6. Em **Authentication**, escolha **OAuth**.
7. Se aparecer uma escolha para registrar o cliente, use **Client ID Metadata Documents (CIMD)**. A Spryx também é compatível com registro dinâmico, quando essa for a opção oferecida pelo workspace.
8. Se o formulário pedir um ícone, baixe `https://api.spryx.ai/mcp/icon.png` e envie o arquivo.
9. Leia o aviso de segurança, marque **I understand and want to continue** e clique em **Create as a plugin**.
10. Revise as ferramentas encontradas e instale o plugin.
11. Abra uma nova conversa no modo **Work**, digite `@` e selecione **Spryx**.

Durante a conexão ou no primeiro uso, o ChatGPT abrirá a Spryx no navegador para você autorizar o acesso. As regras de segurança do seu workspace do ChatGPT podem ocultar ou bloquear a criação de servidores MCP personalizados.

Esses nomes de tela seguem o fluxo atual da [documentação oficial da OpenAI](https://developers.openai.com/plugins/deploy/connect-chatgpt).

## Autorize o acesso na Spryx {#autorize-o-acesso-na-spryx}

Todos os clientes compatíveis usam a mesma tela de autorização da Spryx.

1. Entre na Spryx, caso a página de login seja exibida.
2. Em **Organização**, escolha o workspace que o assistente poderá acessar.
3. Confira seu papel no workspace.
4. Revise as permissões. Marque somente as capacidades necessárias.
5. Clique em **Permitir acesso**.
6. Aguarde o retorno à ferramenta em que iniciou a conexão.

![Tela Conectar o Claude à Spryx com seletor de organização, cinco grupos de permissões e botão Permitir acesso.](https://cdn.sanity.io/images/qbc9enz0/production/1161b81f0c13956b95ca300e5cfa34460e6caaff-960x1960.png?w=1600&fit=max&auto=format)

_A conexão vale somente para o workspace selecionado e respeita o papel da pessoa que está autorizando._

O pedido de conexão vale por 10 minutos. Se ele expirar, feche a página e recomece a conexão pela ferramenta escolhida.

## Entenda as permissões {#entenda-as-permissoes}

- **Registros, listas e tarefas:** permite procurar, criar, editar e arquivar Records, trabalhar com Lists e gerenciar tarefas. Esta é a permissão básica da conexão.
- **Estrutura da organização:** permite criar ou alterar Objects, atributos, estruturas de etapas e Views. Libere apenas quando o assistente precisar administrar o modelo de dados.
- **Conversas:** permite ler conversas, mensagens, notas internas e contatos que você já pode visualizar.
- **Organizar conversas:** permite atribuir, encerrar ou reabrir conversas, alterar prioridade e etapa e ligar ou desligar o agente de IA.
- **Enviar mensagens:** permite responder clientes, usar templates e adicionar notas internas em seu nome.

As permissões da conexão não substituem as permissões do workspace. Se o seu papel não pode realizar uma ação, a ferramenta conectada também não poderá. Uma opção indisponível na tela indica que seu papel não permite concedê-la.

> **Risco**
>
> **Revise ações que afetam clientes.** As permissões de organizar conversas e enviar mensagens produzem efeitos reais. Antes de aprovar uma ação no assistente, confira o contato, o canal, o texto e o resultado esperado.

## Teste a conexão {#teste-a-conexao}

Comece com uma consulta que não altera dados. Por exemplo:

- “Quais tarefas vencem hoje?”
- “Encontre o contato com o e-mail cliente@empresa.com.”
- “Liste cinco negócios atualizados mais recentemente.”

Confira se o assistente identifica a Spryx como ferramenta e se os resultados pertencem ao workspace correto. Depois, teste uma ação simples, como “Crie uma tarefa para eu revisar este contato amanhã”, e confirme os dados antes de aprovar.

No ChatGPT, selecione o plugin com `@Spryx` na conversa. No Claude, confirme que a Spryx está habilitada em **Busca e ferramentas**. Em outro cliente, ative o servidor ou as ferramentas da Spryx conforme a interface do aplicativo.

## Veja ou altere uma conexão {#veja-ou-altere-uma-conexao}

Na Spryx:

1. Abra **Configurações**.
2. Em **Pessoal**, clique em **Apps conectados**.
3. Localize o Claude, ChatGPT ou outro cliente conectado.

Nessa página, você pode:

- conferir as permissões e o último uso;
- clicar em **Editar permissões** para aumentar ou reduzir o acesso;
- clicar em **Revisar** quando o app solicitar uma nova permissão;
- clicar em **Desconectar** para revogar o acesso imediatamente.

![Página Apps conectados com conexões do Claude, permissões, último uso, revisão de novos acessos e botões para editar ou desconectar.](https://cdn.sanity.io/images/qbc9enz0/production/fbedc783122a02c1c24047ef4b68d3f2bf01a797-2350x1650.png?w=1600&fit=max&auto=format)

_Alterações de permissão valem no próximo pedido; ao desconectar, o app perde o acesso imediatamente._

Administradores também veem **Permitir apps externos**. Ao desativar essa opção, todas as conexões externas do workspace são encerradas e novas conexões ficam bloqueadas.

## Perguntas frequentes

### A opção de adicionar um conector não aparece. O que faço?

Primeiro, confirme se a ferramenta aceita servidores MCP remotos por HTTPS com OAuth. No Claude, confira também se sua conta usa um plano compatível; em contas Team ou Enterprise, peça ao responsável pela organização para adicionar o conector. No ChatGPT, confirme se a política do workspace permite servidores MCP personalizados.

### Por que a Spryx informa que os apps externos estão desativados?

Um administrador desativou **Permitir apps externos** no workspace. Peça a um Admin ou Owner para revisar essa configuração.

### O pedido de conexão expirou. Como recomeço?

Volte à ferramenta em que iniciou a conexão e clique em conectar novamente. Não reutilize a aba antiga: cada pedido de autorização é temporário.

### Por que meu workspace não aparece?

Confirme se você entrou na conta correta e se ainda é membro do workspace. Se o workspace estiver com apps externos desativados, ele não poderá ser selecionado.

### Por que a ferramenta consegue consultar, mas não alterar algo?

Abra **Configurações → Pessoal → Apps conectados** e confira as permissões da conexão. Se a permissão estiver ativa, verifique também se o seu papel na Spryx permite a ação.

### A conexão existe, mas não é usada na conversa. Como resolvo?

Confirme se o servidor e as ferramentas da Spryx estão habilitados para a conversa. No Claude, use **Busca e ferramentas**. No ChatGPT, abra uma conversa no modo Work, digite `@` e selecione o plugin Spryx. Em outro cliente, procure a área de ferramentas ou conectores. Depois de alterar uma conexão, inicie uma nova conversa para carregar as ferramentas atualizadas.

### Conectei o workspace errado. Como faço para trocar?

Desconecte o app em **Apps conectados** e inicie a conexão novamente, selecionando o workspace correto.

> **Atenção**
>
> **Autorize o menor acesso possível.** Comece apenas com as permissões necessárias para o primeiro uso. Você pode ampliar o acesso mais tarde em Apps conectados e desconectar aplicativos que não são mais usados.