SimplyBoost MCP

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

O que é

O servidor MCP está em https://get-api.simplyboost.io/api/v1/mcp. Ele usa o transporte HTTP Streamable e o mesmo token de API da API REST (Authorization: Bearer sb_live_…), os mesmos planos (Growth, Pro e Enterprise), as mesmas permissões e os mesmos limites. Cada ferramenta faz o que o endpoint REST correspondente faz e exige o mesmo escopo; se o assistente vir uma ferramenta que não pode usar, receberá uma recusa clara, não um erro.

Ele é sem estado: cada chamada é uma solicitação e uma resposta, sem sessão para manter, então você pode se conectar de qualquer máquina. O servidor nunca inicia um fluxo por conta própria.

Conectar um cliente

Há duas formas de entrar. Entrar (OAuth): adicione o endereço do servidor e, quando o cliente solicitar, aprove a conexão em uma aba do SimplyBoost como proprietário da equipe, escolhendo a equipe, as permissões e os chatbots. É assim que os conectores do claude.ai e do ChatGPT, o Cursor, o Codex e o Claude Code se conectam, sem precisar colar nada. Um token: para um cliente que você configura manualmente ou um script próprio, crie um token em Configurações → API com apenas as permissões de que o assistente precisa e envie-o como cabeçalho.

Claude Code (entre quando solicitado)

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor, Windsurf, VS Code e outros clientes com um mcp.json (entre quando solicitado)

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

O mesmo, usando um token em vez de entrar

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

Uma conexão feita ao entrar dura 90 dias, recebe apenas as permissões que o proprietário deixou marcadas (a exclusão fica desativada, a menos que seja marcada) e aparece em Configurações → API → Aplicativos conectados, onde o proprietário pode desconectá-la a qualquer momento. Somente o proprietário de uma equipe pode aprovar uma conexão, a mesma regra aplicada à criação de um token. O nome do aplicativo na tela de aprovação é o nome que o próprio aplicativo declarou; o SimplyBoost não o verifica.

Um token na configuração de um cliente é uma senha da sua conta. Mantenha-o no seu próprio computador, defina uma data de expiração e troque-o se o arquivo de configuração for compartilhado. Entrar evita esse problema: nenhum segredo é gravado em um arquivo.

Para desenvolvedores de clientes: o servidor segue a especificação de autorização do MCP. Uma solicitação sem credenciais responde 401 com um cabeçalho WWW-Authenticate que indica os metadados do recurso protegido (https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp), que indicam o servidor de autorização (https://get-api.simplyboost.io/.well-known/oauth-authorization-server). Os clientes registram a si mesmos (Dynamic Client Registration), usam o fluxo de código de autorização com PKCE (somente S256), podem indicar o recurso e recebem tokens de atualização rotativos. Os tokens de acesso duram uma hora e funcionam apenas no endpoint MCP; os endpoints REST aceitam tokens de API.

As ferramentas

Os argumentos e resultados usam os mesmos nomes da API REST (chatbotId, threadId, campos camelCase), então as páginas dos endpoints descrevem ambos. Comece com list_chatbots para encontrar o ID de um chatbot.

Ferramenta	Requer	Faz
get_account	nada	A conta, o plano e as próprias permissões do token.
get_usage	account:read	Mensagens usadas neste período de cobrança.
list_chatbots, get_chatbot	chatbots:read	Os chatbots que o token pode usar.
send_message	conversations:write	Faça uma pergunta a um chatbot como um visitante faria; conta para o limite de mensagens do plano. Passe threadId para continuar.
list_conversations, get_conversation, list_messages	conversations:read	Conversas em todos os canais e suas mensagens.
take_over_conversation, reply_to_conversation, hand_back_to_chatbot, resolve_conversation	conversations:write	Atenda a uma conversa como uma pessoa: assuma, responda, devolva, resolva ou reabra.
list_leads, get_lead	leads:read	Os leads capturados por um chatbot.
update_lead	leads:write	Altere os dados de um lead ou marque-o como convertido.
delete_lead	leads:delete	Exclua um lead.
list_knowledge_sources, get_knowledge_source	knowledge:read	O que um chatbot sabe, com o status e o texto de cada fonte.
add_text_knowledge, add_website_knowledge, update_knowledge_source, refresh_knowledge_source	knowledge:write	Ensine texto ou um site ao chatbot, edite uma fonte ou leia um site novamente.
delete_knowledge_source	knowledge:delete	Remova uma fonte.

Uploads de arquivos e webhooks não são oferecidos como ferramentas; use os endpoints REST para isso. As ferramentas de exclusão são marcadas como destrutivas, e as instruções do servidor orientam o assistente a perguntar antes.

Erros e limites

Uma chamada de ferramenta recusada (por falta de permissão, um chatbot que o token não pode acessar, um argumento inválido ou um limite do plano) retorna um resultado de ferramenta marcado como erro, com o mesmo code e a mensagem que a API REST retornaria, para que o assistente possa dizer o que você precisa alterar. Um token ausente ou inválido responde 401; um plano sem acesso à API ou uma assinatura vencida responde 403; e o limite de solicitações por token responde 429, exatamente como na API REST.

Uma mensagem que não seja JSON-RPC 2.0 gera um erro JSON-RPC. GET e DELETE no endpoint respondem 405, pois não há sessão nem fluxo do servidor.