Conectar um assistente de IA ao SuperSaaS

O SuperSaaS oferece um servidor MCP (Model Context Protocol) que permite que assistentes de IA como Claude ou ChatGPT gerenciem sua agenda em linguagem natural: verificar disponibilidade, criar e mover reservas, pesquisar usuários e muito mais. O assistente tem o mesmo acesso que a sua conta, portanto trate os dados de conexão como uma senha.

O que você poderá fazer

Após a configuração, você pode fazer perguntas e solicitações ao seu assistente de IA, como:

“Quais compromissos tenho amanhã?”
“Encontre um horário livre para uma consulta de 30 minutos na próxima semana e reserve para jane@example.com”
“Quais reservas mudaram desde ontem?”
“Crie um novo usuário com o nome jim@example e a senha ‘secret’ e dê a ele R$ 20 de crédito”

A maioria dos assistentes pedirá confirmação antes de realizar alterações importantes, mas lembre-se de que a conexão atua com suas permissões de administrador.

Escolha o seu cliente

A maioria dos usuários deve se conectar via OAuth. Você insere a URL do servidor, faz login no SuperSaaS pelo navegador e aprova o acesso.

Clientes com OAuth: ChatGPT e Claude
Outros clientes: Claude Code, Codex, Visual Studio Code e outros clientes MCP

Para clientes com OAuth, use esta URL do servidor: https://www.supersaas.com.br/mcp

ChatGPT

O ChatGPT se conecta inserindo a URL do servidor e aprovando a conexão no SuperSaaS. O ChatGPT exige um plano pago (Plus, Pro ou Business) para conectores personalizados.

Acesse https://chatgpt.com para se conectar. Use a versão web; o app móvel e o desktop do ChatGPT ainda não têm opção MCP, mas após a conexão você pode usar as ferramentas pelo app.
Abra Settings > Apps, role até Advanced settings e ative o Developer mode.
De volta em Apps, escolha Create app, nomeie-o “SuperSaaS” e em conexão insira “https://www.supersaas.com.br/mcp”.
Em Authentication, certifique-se de que OAuth está selecionado, marque a caixa de confirmação e conclua a criação do conector. Ao se conectar, uma página do SuperSaaS abre no navegador; faça login e clique em Aprovar para retornar ao ChatGPT com as ferramentas disponíveis.

Claude (aplicativo de desktop e web)

O Claude se conecta ao SuperSaaS como um conector personalizado. Você só precisa da URL do servidor; faz login no SuperSaaS pelo navegador e aprova a conexão.

No Claude, abra Settings > Connectors e clique em Add custom connector.
Insira um nome como “SuperSaaS” e cole a URL do seu servidor (https://www.supersaas.com.br/mcp), depois clique em Add.
Clique em Connect. Uma página do SuperSaaS abre no navegador; faça login com o seu nome de conta e senha (se ainda não estiver logado) e clique em Aprovar.
Você retorna ao Claude, que agora lista as ferramentas do SuperSaaS sob o ícone de ferramentas na caixa de chat.

Configuração manual para clientes sem OAuth

Alguns clientes ainda não suportam o fluxo de login pelo navegador. Esses clientes precisam da URL do servidor e de um valor Authorization que começa com Bearer …. Você pode encontrar esse valor clicando em Conectar um assistente de IA, que abrirá sua página Informações de conta com uma seção adicional. Clique em Revelar para ver o código Authorization.

Se você clicar em Gerar nova chave posteriormente, o valor Authorization muda e qualquer assistente conectado que o utilize para de funcionar até que você o atualize com o novo valor.

Claude Code (terminal)

Execute este único comando, substituindo o marcador de posição pelo seu valor Authorization:

claude mcp add supersaas --transport http https://www.supersaas.com.br/mcp \
  --header "Authorization: Bearer COLE_SEU_VALOR_AQUI"

Codex

A maneira mais fácil é pelo aplicativo Codex:

Abra Settings no Codex.
Vá em MCP servers e clique em Add.
Escolha um servidor remoto/HTTP e insira a URL do seu servidor.
Adicione um cabeçalho HTTP chamado Authorization com o seu valor Authorization (incluindo a palavra Bearer).
Salve o servidor e inicie um novo chat no Codex. As ferramentas do SuperSaaS devem estar disponíveis nesse chat.

Se preferir o terminal ou quiser configurar o Codex manualmente, edite ~/.codex/config.toml (crie-o se não existir) e adicione:

[mcp_servers.supersaas]
url = "https://www.supersaas.com.br/mcp"
http_headers = { "Authorization" = "Bearer COLE_SEU_VALOR_AQUI" }

Reinicie o Codex depois; as ferramentas do SuperSaaS aparecem automaticamente. No terminal, você pode verificar a conexão com codex mcp list, e dentro do Codex você pode usar /mcp para inspecionar os servidores conectados.

Visual Studio Code (GitHub Copilot)

No VS Code, os servidores MCP são usados pelo chat do GitHub Copilot no modo agente, portanto uma assinatura do Copilot é necessária (o nível gratuito funciona).

Abra a paleta de comandos (Ctrl/Cmd + Shift + P) e execute MCP: Add Server.
Escolha HTTP e insira a URL do seu servidor.
Quando o arquivo mcp.json abrir, adicione a entrada headers para que a definição do servidor fique assim:

{
  "servers": {
    "supersaas": {
      "type": "http",
      "url": "https://www.supersaas.com.br/mcp",
      "headers": {
        "Authorization": "Bearer COLE_SEU_VALOR_AQUI"
      }
    }
  }
}

Abra o painel de chat do Copilot, mude o menu suspenso de modo para Agent e clique no ícone de ferramentas para confirmar que as ferramentas do SuperSaaS estão listadas.

Outros clientes MCP (Cursor, Le Chat e mais)

Qualquer cliente que suporte servidores MCP remotos com cabeçalhos personalizados funcionará. Onde o cliente solicitar os detalhes do servidor, use:

Tipo / transporte: Streamable HTTP
URL: a URL do seu servidor, por exemplo https://www.supersaas.com.br/mcp
Cabeçalho: Authorization definido com o seu valor Authorization (incluindo a palavra Bearer)

Para clientes configurados com um arquivo JSON (como o mcp.json do Cursor), o equivalente é:

{
  "mcpServers": {
    "supersaas": {
      "url": "https://www.supersaas.com.br/mcp",
      "headers": {
        "Authorization": "Bearer COLE_SEU_VALOR_AQUI"
      }
    }
  }
}