Conecte a Spryx a ferramentas de IA via MCP

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.

O que você 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.

Conecte em outra ferramenta compatível

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

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 ↗.

Conecte no ChatGPT

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

1. Abra a área de Plugins do ChatGPT ↗.
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 ↗.

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.

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

• 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.

Teste a conexão

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

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.

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.