Conecte a Ringhum ao Claude e outras ferramentas de IA (MCP)

A Ringhum tem um servidor MCP. O MCP (Model Context Protocol) é uma forma padrão de apps de IA usarem ferramentas externas. Depois que você conecta a Ringhum a um app de IA como o Claude ou o ChatGPT, pode fazer perguntas sobre o seu workspace em linguagem natural. Por exemplo: "Resuma as chamadas perdidas de ontem", "Quais pessoas pediram retorno de chamada esta semana?" ou "Adicione nosso novo horário de funcionamento às perguntas frequentes". O app de IA opera sob as mesmas regras e permissões que a API da Ringhum.

O que você precisa

• URL do servidor: https://ringhum.com/mcp. Também é mostrada no card Servidor MCP na página Desenvolvedores, com um botão Copiar.
• Um app de IA que suporte servidores MCP remotos, como Claude, ChatGPT, Claude Code, Cursor, Windsurf ou VS Code.
• Função de Proprietário ou Admin no workspace. Somente proprietários e admins podem conectar um app ou criar uma chave de API.

Há duas formas de conectar. Fazer login é a mais fácil e serve para apps de chat como Claude e ChatGPT. Uma chave de API serve para ferramentas de desenvolvedor que aceitam uma URL e um cabeçalho.

Acesso somente leitura ou de leitura e alteração

Você escolhe quanto o app de IA pode fazer.

Com acesso somente leitura, as ferramentas que alteram algo simplesmente não são oferecidas ao app.

Importante: Com acesso de alteração, o app de IA pode enviar mensagens reais e fazer chamadas reais para seus clientes. A Ringhum marca essas ferramentas como alcançando fora do seu workspace, e as exclusões como destrutivas, então a maioria dos apps de IA pede sua aprovação antes de executá-las. Leia o que o app está prestes a fazer antes de aprovar.

Conecte o Claude fazendo login

1. No Claude (na web, no desktop ou no celular), abra Configurações → Conectores e escolha Adicionar conector personalizado.
2. Cole https://ringhum.com/mcp como a URL e salve.
3. Clique em Conectar. Uma página da Ringhum se abre. Faça login se for solicitado.
4. Na página Conectar, escolha o Workspace que o app pode usar.
5. Em O que ele pode fazer, escolha Consultar informações ou Consultar informações e fazer alterações.
6. Clique em Permitir. Você é enviado de volta ao Claude.

O app nunca vê sua senha. Os nomes exatos dos menus no Claude podem mudar com o tempo; procure por conectores ou integrações nas configurações dele.

ChatGPT: adicione a URL como um conector personalizado (servidor MCP) em Configurações → Apps e conectores, depois clique em Conectar e siga os passos de 3 a 6.

Claude Code: execute o comando abaixo, depois execute /mcp e escolha Autenticar.

claude mcp add --transport http ringhum https://ringhum.com/mcp

Depois que você permite o acesso, a conexão se renova sozinha enquanto você continuar usando-a. Se o app não for usado por 90 dias, você precisará conectá-lo novamente.

Conecte com uma chave de API

Use isso para ferramentas que permitem definir um cabeçalho de requisição, ou quando você não quer fazer login.

1. Em Desenvolvedores, crie uma chave de API. Marque apenas leitura para uma conexão somente leitura, ou leitura e gravação para permitir alterações. Veja Chaves de API e escopos.
2. Adicione o servidor ao seu app com a chave no cabeçalho Authorization.

Claude Code:

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor (~/.cursor/mcp.json), Windsurf e Claude Desktop:

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

Um app que só consegue rodar servidores locais pode se conectar por meio de npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

O que as ferramentas cobrem

Toda operação na API da Ringhum está disponível como uma ferramenta: sua conta e uso, assistentes, números de telefone, chamadas e transcrições, contatos, compromissos e disponibilidade, pedidos e produtos, reservas de quarto, a caixa de entrada, mensagens de texto e WhatsApp, campanhas, webhooks, o perfil da empresa, serviços, perguntas frequentes e base de conhecimento, perguntas não respondidas, links de pagamento, pedidos de avaliação, receita e proteção contra spam. As gravações de chamadas são a única exceção: não estão disponíveis como uma ferramenta.

Cada ferramenta executa a requisição de API correspondente, então os mesmos limites de plano, validações e limites de taxa se aplicam. As chamadas de ferramenta contam para o limite da API de 120 requisições por minuto. A lista completa de ferramentas está na seção MCP da referência da API em /docs.

Veja e desconecte apps conectados

Os apps que você conectou fazendo login são listados em Desenvolvedores em Aplicativos de IA conectados, com quem os conectou, seu Acesso (Somente leitura ou Ler e alterar) e quando foram usados pela última vez.

Para remover um app, clique em Desconectar e confirme. Ele perde o acesso imediatamente e precisa ser aprovado novamente. Para alterar o acesso de um app, desconecte-o e conecte-o novamente com a outra opção.

Para uma conexão feita com uma chave de API, revogue a chave em Chaves de API.

Solução de problemas

"Somente proprietários e admins de um workspace podem conectar apps." Peça ao proprietário do workspace para conectar o app, ou para torná-lo um Admin. Veja Convide sua equipe.

"A solicitação de login expirou. Comece a conectar novamente a partir do seu app de IA." A página de aprovação ficou aberta por tempo demais. Comece novamente a partir do app de IA.

O app diz que não está autorizado, ou pede que você faça login novamente. O app foi desconectado, a chave foi revogada, ou você não é mais membro do workspace. Conecte-o novamente.

O app não consegue fazer alterações. Ele foi conectado com acesso somente leitura, ou sua chave de API não tem o escopo de gravação.

O app está olhando para o workspace errado. Peça a ele para chamar who_am_i para verificar. Cada conexão usa um workspace. Desconecte-o e conecte-o novamente para escolher outro.