Construa com o Simplafy Hub.
Quatro portas para ligar o Hub ao seu sistema, ao seu assistente de IA e ao seu código: conversar com os agentes, mandar dados, operar o Hub inteiro e publicar agentes como código.
Qual porta usar
1 · MCP — o Hub inteiro dentro do seu assistente de IA
Para que serve. Conecte o ChatGPT, o Claude ou qualquer cliente MCP ao Hub e opere tudo conversando: contatos, negócios, funis, agentes, jornadas, campanhas, catálogo, nota fiscal, painéis e mais. Tudo o que a tela faz, o MCP faz.
- 1No Hub, vá em Configurações › Assistentes de IA e copie o endereço.
- 2Cole no seu assistente como servidor MCP (conector personalizado).
- 3Entre com a sua conta do Hub e escolha as áreas que ele pode ver e mexer, só leitura ou leitura e escrita.
Prefere o app oficial? Procure «Simplafy Hub» na loja do ChatGPT ou no diretório do Claude.
https://mcp-hub.simplafy.com.br/completo
Configurações › Conectores › Adicionar conector personalizado, e cole o endereço.
https://mcp-hub.simplafy.com.br/completo
Use o app oficial «Simplafy Hub» na loja do ChatGPT ou, em conectores personalizados, cole o endereço.
https://mcp-hub.simplafy.com.br/completo
No terminal:
claude mcp add --transport http simplafy-hub https://mcp-hub.simplafy.com.br/completo
Em ~/.cursor/mcp.json:
{
"mcpServers": {
"simplafy-hub": {
"url": "https://mcp-hub.simplafy.com.br/completo"
}
}
}Em .vscode/mcp.json:
{
"servers": {
"simplafy-hub": {
"type": "http",
"url": "https://mcp-hub.simplafy.com.br/completo"
}
}
}- Transporte: MCP Streamable HTTP (JSON-RPC 2.0).
- Autenticação: OAuth 2.1 com registro automático do cliente e PKCE. Não precisa de chave.
- O assistente nunca tem mais poder que o papel da pessoa na organização.
- Mais de 140 ferramentas no acesso completo.
- Sessão: o acesso renova sozinho por até 30 dias; revogue quando quiser em Configurações › Meus assistentes.
hub.<área>.read / hub.<área>.write):Ver o Hub no ChatGPT e no Claude, para quem não é desenvolvedor →
2 · Agent API — o seu sistema conversa com um agente
Para que serve. O seu site, app ou sistema manda uma pergunta ou uma tarefa e o agente do Hub responde, com as mesmas ferramentas, base de conhecimento e regras que ele usa no WhatsApp. A resposta pode vir em texto, em tempo real, em formato estruturado (JSON) ou em arquivo, como um PDF gerado.
- 1No Hub, em Integrações › Canais, crie um canal Agent API e ligue a ele o agente.
- 2Escolha os comportamentos que quer usar: Executar, Tempo real, Estruturado e Arquivo. Cada um ligado ganha o seu endereço, para copiar.
- 3Gere o token do canal. Ele aparece uma vez só; dá para girar e revogar.
https://api-hub-v2.simplafy.com.br/api/v1/agent-api/{nome-do-canal}- Autenticação: Authorization: Bearer <token do canal>.
- Cabeçalho obrigatório: Idempotency-Key: <id único do pedido>. Repetir o mesmo id não executa duas vezes.
- Corpo em JSON, até 256 KiB: { "input": "texto para o agente, até 32 mil caracteres", "data": { …dados opcionais… } }.
| Rota | O que devolve |
|---|---|
POST /run | A resposta final: { "version": "1", "requestId", "status": "completed", "text", "parts" } |
POST /stream | A resposta em tempo real (SSE, eventos AG-UI), com retomada por Last-Event-ID |
POST /structured | Um JSON validado no formato definido no canal: { …, "data": {…} } |
POST /file | Os arquivos que o agente gerou: { …, "text", "files": [...] } |
POST /openai/v1/chat/completions | Compatível com a API da OpenAI (ex.: para ligar a ElevenLabs ao agente) |
curl -X POST https://api-hub-v2.simplafy.com.br/api/v1/agent-api/meu-canal/run \
-H "Authorization: Bearer $TOKEN_DO_CANAL" \
-H "Idempotency-Key: pedido-123" \
-H "Content-Type: application/json" \
-d '{"input":"Qual o prazo de entrega para Brasília?","data":{"pedido":"123"}}'Sempre no mesmo formato:
{ "version": "1", "requestId": "…", "error": { "code": "INVALID_TOKEN", "message": "…", "retryable": false } }| HTTP | code | Quando |
|---|---|---|
| 400 | INVALID_REQUEST | Corpo inválido, sem Idempotency-Key, campo além de input/data ou acima de 256 KiB |
| 401 | INVALID_TOKEN | Token ausente ou errado |
| 403 | BEHAVIOR_DISABLED | Esse comportamento está desligado no canal |
| 404 | CHANNEL_NOT_FOUND | O canal não existe |
| 409 | AGENT_NOT_LINKED | O canal não está ligado a nenhum agente |
| 422 | NO_FILE_GENERATED | Na rota /file, o agente não gerou arquivo |
| 503 | AGENT_UNAVAILABLE | O agente está desligado ou indisponível (tente de novo) |
3 · Webhook de entrada — mande dados para o Hub
Para que serve. Qualquer sistema, formulário do site, n8n, Make ou Zapier manda dados para o Hub, e o Hub usa isso numa Jornada: criar contato e negócio, mover de etapa, gravar na Tabela de Dados, avisar a equipe ou acionar um agente.
- 1No Hub, em Integrações › Webhook, crie o webhook e copie o endereço e o token.
- 2Na Jornada, use o gatilho «Webhook» e escolha o que fazer com os dados.
curl -X POST https://api-hub-v2.simplafy.com.br/api/v1/webhooks/in/{orgId}/{caminho} \
-H "X-Webhook-Token: $TOKEN_DO_WEBHOOK" \
-H "Content-Type: application/json" \
-d '{"nome":"Maria","telefone":"+55 61 90000-0000"}'- Endereço: https://api-hub-v2.simplafy.com.br/api/v1/webhooks/in/{orgId}/{caminho}. A tela entrega pronto, com o exemplo em cURL.
- Método POST. Aceita JSON, formulário (form-urlencoded) e multipart com arquivo. Funciona direto de formulário HTML (CORS).
- Autenticação: cabeçalho X-Webhook-Token (ou ?token= na URL). Opcional: Bearer ou assinatura HMAC (X-Webhook-Signature).
- Dá para trocar o token e desfazer a remoção do webhook.
Ainda não tem: validação do formato do corpo, lista de IPs permitidos e webhook de saída. Para o Hub chamar o seu sistema, use o passo «Chamar endpoint» da Jornada.
4 · ADK — agentes, ferramentas e jornadas como código BETA
Para que serve. Para times técnicos e parceiros: escreva agentes, ferramentas (em Python), tabelas, jornadas e aplicativos em arquivos, guarde no Git, valide na sua máquina e publique no Hub com um comando. O que já está no Hub também pode ser exportado para arquivos.
npx @simplafy-tec/adk doctor # confere o ambiente npx @simplafy-tec/adk login # entra com a conta do Hub npx @simplafy-tec/adk init tool minha-tool && cd minha-tool npx @simplafy-tec/adk build # valida e procura segredo vazado npx @simplafy-tec/adk deploy --org <orgId>
- Pacote @simplafy-tec/adk no npm (Node 20 ou mais). Comandos: doctor, login/logout, init tool|mcp|app, build, test, dev, validate, plan, deploy, status, export, mcp-server.
- Login por OAuth do Hub (fica salvo na máquina e renova sozinho). Para CI: ADK_TOKEN + --org.
- Publica na ordem ferramenta → agente → jornada; o que falha não derruba o resto e sai num relatório.
- plan mostra o que vai mudar antes de aplicar; export traz do Hub o que já existe; status lista o que ficou pendente.
- O build reprova segredo no código: a credencial fica no Hub e é citada pelo nome.
Versão 0.1.0. A documentação completa do ADK ainda está sendo escrita.