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

Está migrando de outro sistema de reservas? Compromissos existentes não podem ser importados pela importação CSV comum, que só aceita usuários, mas um assistente de IA pode fazer isso por você. Exporte os compromissos do seu sistema antigo, entregue o arquivo ao assistente e peça que ele crie as reservas na agenda correspondente do SuperSaaS. Comece com um lote pequeno e confira o resultado antes de deixar que ele importe o restante.

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.

Configuração pela web: ChatGPT e Claude
Configuração no desktop ou no terminal: Claude Code, aplicativo de desktop do ChatGPT e Codex, Visual Studio Code e outros clientes MCP

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

ChatGPT (versão web)

O ChatGPT se conecta inserindo a URL do servidor e aprovando a conexão no SuperSaaS. Você adiciona a conexão como um plug-in pessoal. A disponibilidade do modo de desenvolvedor depende da sua conta e da política do seu espaço de trabalho. Os passos abaixo usam os nomes em inglês dos botões e menus.

Acesse https://chatgpt.com para se conectar.
Abra Settings > Security and login e ative o Developer mode.
Abra Plugins e escolha Create app. No formulário New Plugin, nomeie-o “SuperSaaS” e insira “https://www.supersaas.com.br/mcp” em MCP Server URL. A descrição é opcional.
Deixe Authentication definido como OAuth, leia o aviso, marque I understand and want to continue e clique em Create. Ao se conectar, uma página do SuperSaaS abre no navegador; faça login e clique em Aprovar para retornar ao ChatGPT.
Encontre o SuperSaaS nos seus plug-ins pessoais, abra-o e clique no botão de mais para instalá-lo.
Volte à página inicial do ChatGPT, mude de Chat para Work e inicie um novo chat. Digite @ na caixa de mensagem e selecione SuperSaaS para usar as ferramentas.

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 Customize > Connectors (o ícone de caixa de ferramentas na parte inferior da barra lateral), clique no botão + e escolha 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. Ative o conector para uma conversa clicando no botão + na caixa de chat (ou digitando /), passando o mouse sobre Connectors e ativando o SuperSaaS. As ferramentas do SuperSaaS ficam então disponíveis nesse chat.

Em um plano Team ou Enterprise, o conector é adicionado pelo proprietário do espaço de trabalho em Organization settings > Connectors; os demais membros só precisam clicar em Connect e fazer login no SuperSaaS. Uma conta gratuita do Claude pode ter um conector personalizado, os planos pagos permitem vários. Depois que o conector for adicionado na versão web ou no aplicativo de desktop, ele também funciona nos aplicativos do Claude para iOS e Android.

Configuração manual com um valor Authorization

Se o seu cliente não suporta OAuth, ou se você prefere a configuração manual, use a URL do servidor e 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, aplicativo de desktop e IDE)

O Claude Code também suporta OAuth, então não é necessário nenhum valor Authorization. Adicione o servidor com este comando:

claude mcp add --transport http supersaas https://www.supersaas.com.br/mcp

Em seguida, digite /mcp no Claude Code, selecione SuperSaaS e siga os passos no navegador para fazer login e aprovar o acesso. O Claude Code armazena o token e o renova automaticamente. O mesmo comando funciona no terminal, no aplicativo de desktop do Claude Code e nas extensões para Visual Studio Code e JetBrains.

Para usar, em vez disso, o valor Authorization da seção de configuração manual acima, passe-o como cabeçalho:

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

Aplicativo de desktop do ChatGPT e Codex

O aplicativo de desktop do ChatGPT permite configurar o MCP diretamente, incluindo o login via OAuth. Codex é o nome do ambiente de programação e do cliente para o terminal. Para se conectar pelo aplicativo de desktop, com os nomes em inglês dos botões e menus:

Mude para Codex no aplicativo de desktop do ChatGPT e abra Settings.
Vá em Plugins, abra o menu Add e escolha Add MCP server. Se a sua versão tiver uma seção MCP servers separada nas configurações, abra essa seção e clique em Add server.
Nomeie o servidor como SuperSaaS, escolha Streamable HTTP e insira https://www.supersaas.com.br/mcp.
Salve o servidor e escolha Restart.
Abra a aba MCPs em Settings > Plugins e escolha Authenticate para o SuperSaaS. Faça login no SuperSaaS pelo navegador e clique em Aprovar.
Inicie um novo chat local no Codex e use /mcp para verificar se o servidor SuperSaaS está conectado.

O aplicativo de desktop, o cliente Codex para o terminal e a extensão para IDE compartilham a configuração do MCP no mesmo computador. Como alternativa ao OAuth, você pode usar o valor Authorization da seção de configuração manual acima. 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"
      }
    }
  }
}