Servidor MCP
Conecte o OrbitSender direto ao seu editor com IA (Claude Code, Cursor, Windsurf, Zed) via Model Context Protocol.
O @orbitsender/mcp expõe a plataforma como ferramentas de
MCP — o protocolo que editores com IA usam para acessar
sistemas externos. Na prática: você conversa com a IA do seu editor e ela opera a sua conta.
"Dispare a campanha da Black Friday no segmento Clientes VIP e me avise quando terminar."
Precisa de uma chave
Use a mesma sk_live_... da API externa. Veja
Autenticação.
Instalar
Não precisa instalar nada à mão — o npx baixa na hora. A configuração é a mesma em
qualquer editor compatível:
{
"mcpServers": {
"orbitsender": {
"command": "npx",
"args": ["-y", "@orbitsender/mcp"],
"env": { "ORBITSENDER_API_KEY": "sk_live_..." }
}
}
}Onde colar:
| editor | arquivo |
|---|---|
| Claude Code | um comando só, abaixo |
| Cursor | ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto) |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Zed | settings.json, em context_servers |
| Claude Desktop | claude_desktop_config.json |
No Claude Code dá para pular o arquivo:
claude mcp add orbitsender --env ORBITSENDER_API_KEY=sk_live_... -- npx -y @orbitsender/mcpCuidado com a chave no arquivo de config
Esses arquivos costumam ir para dotfiles versionados. Uma sk_live_ ali é uma credencial
de produção em texto puro — não commite. Para experimentar, prefira uma chave
sk_test_, que a API responde em modo sandbox.
As ferramentas
A toolset é curada por jornada, não um espelho 1:1 dos endpoints. É isso que permite pedir "dispare e me avise quando terminar" em vez de encadear seis chamadas REST.
| ferramenta | o que faz |
|---|---|
orbitsender_account_overview | plano, limites e situação da conta |
orbitsender_search_segments · orbitsender_create_segment | achar e criar segmentos |
orbitsender_search_channels · orbitsender_list_channel_groups | canais e seus grupos |
orbitsender_start_channel_connection · orbitsender_disconnect_channel | conectar (QR) e desconectar |
orbitsender_launch_campaign | disparar campanha |
orbitsender_wait_for_campaign · orbitsender_campaign_status · orbitsender_list_campaigns | acompanhar até o fim |
orbitsender_diagnose_delivery | investigar por que uma campanha não entregou |
orbitsender_get_settings · orbitsender_configure_webhook | configuração e webhooks |
O disparo tem confirmação humana obrigatória: a IA não envia campanha sem você aprovar.
Verificar se está funcionando
Depois de configurar, reinicie o editor e peça algo simples — "qual o meu plano no OrbitSender?". Se a IA responder com os seus limites reais, está conectado.
Para testar fora do editor:
ORBITSENDER_API_KEY=sk_live_... npx -y @orbitsender/mcpO servidor sobe em stdio e imprime OrbitSender MCP no ar (stdio) — modo api-key. no
stderr. Ele fica aguardando o protocolo — é o editor que conversa com ele, não você.
Erro comum
Defina ORBITSENDER_API_KEY (sk_live_...) no ambiente. significa que a variável não chegou
ao processo. Confirme que o env está dentro do bloco do servidor no JSON, e não no
nível de cima.
O que ele usa por baixo
O MCP consome o SDK TypeScript, que por sua vez é gerado da mesma spec OpenAPI desta referência. Ou seja: as três camadas — API, SDK e MCP — nunca divergem do contrato.