Nexus MCP Server
SO de operações nativo para agentes para e-commerce e varejo — CRM, pedidos, estoque, fulfillment, envio, mensagens omnichannel, publicação social, chat de equipe, inteligência de conversa e muito mais. Tudo através de uma única conexão MCP.

O que é o Nexus?
Nexus é uma plataforma de operações multi-tenant construída para PMEs. Ela consolida:
- CRM — contatos, empresas, estágios de jornada, visões de cliente-360
- Gestão de Pedidos — ciclo de vida completo de pendente → entregue
- Estoque e Armazenagem — rastreamento de estoque, bins, contagens cíclicas
- Fulfillment — fluxos de separação, embalagem e envio
- Envio — criação de AWB, integração com transportadora (Bosta), rastreamento
- Mensagens Omnichannel — WhatsApp, Facebook Messenger, DMs do Instagram
- Publicação Social — rascunhos do Facebook e Instagram, agendamento, análises, calendário de conteúdo
- Chat Interno da Equipe — DMs de agente ↔ humano dentro da organização
- Convites de Organização — convidar, cancelar e reenviar convites de membros via agente
- VoIP/PBX — clique para ligar, sincronização de CDR, ramais
- Inteligência de Conversa — anotações de mensagens por IA, análises de CS, definições de tags, perfis de IA da organização
- Automação — fluxos de trabalho orientados a eventos, recuperação de carrinho abandonado
Para Agentes de IA
Nexus é projetado para acesso agente-primeiro. Agentes de IA autenticam com uma chave de API e obtêm mais de 40 ferramentas MCP cobrindo todas as operações de negócios.
Início Rápido (para agentes)
# Step 1: A human admin creates an API key
curl -X POST "https://api.nexus.aiforstartups.io/functions/v1/agent-api-key-create" \
-H "Authorization: Bearer <human-admin-jwt>" \
-H "Content-Type: application/json" \
-d '{
"name": "my-agent",
"scopes": ["read", "write"],
"expires_at": "2026-12-31T23:59:59Z"
}'
# Returns: api_key (save this — shown only once), organization_id
# Step 2: Exchange API key for a short-lived JWT
curl -X POST "https://api.nexus.aiforstartups.io/functions/v1/agent-auth" \
-H "Content-Type: application/json" \
-d '{"api_key": "nxs_ak_..."}'
# Returns: access_token (JWT, 1 hour), organization_id
# Step 3: Use MCP
curl -X POST "https://api.nexus.aiforstartups.io/functions/v1/mcp-server" \
-H "Authorization: Bearer <jwt>" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
Ferramentas MCP
CRM
| Ferramenta | Descrição |
|---|
nexus_list_contacts | Listar/pesquisar contatos com filtros |
nexus_get_contact | Obter detalhes completos do contato |
nexus_create_contact | Criar um novo contato |
nexus_update_contact | Atualizar campos do contato |
Pedidos
| Ferramenta | Descrição |
|---|
nexus_list_orders | Listar pedidos com filtros |
nexus_get_order | Obter pedido com itens de linha |
nexus_create_order | Criar pedido com itens de linha |
nexus_update_order_status | Mover pedido pelo ciclo de vida |
Estoque
| Ferramenta | Descrição |
|---|
nexus_list_inventory | Listar itens de estoque |
nexus_check_stock | Verificar estoque para item/SKU |
Mensagens
| Ferramenta | Descrição |
|---|
nexus_list_conversations | Listar conversas omnichannel |
nexus_send_message | Enviar via WhatsApp/FB/IG |
nexus_search | Pesquisa global em todos os dados |
Social
| Ferramenta | Descrição |
|---|
nexus_sync_social_posts | Sincronizar postagens de contas conectadas |
nexus_list_social_posts | Listar postagens sociais |
nexus_get_social_post | Obter uma única postagem |
nexus_create_social_post | Criar uma postagem de rascunho |
nexus_update_social_post | Atualizar uma postagem de rascunho |
nexus_publish_social_post | Publicar uma postagem |
nexus_delete_social_post | Excluir uma postagem |
nexus_list_social_accounts | Listar contas sociais conectadas |
nexus_get_social_analytics | Obter análises sociais |
nexus_get_content_calendar | Obter calendário de conteúdo agendado |
Organização
| Ferramenta | Descrição |
|---|
nexus_list_organization_invites | Listar convites pendentes |
nexus_invite_organization_member | Convidar um novo membro |
nexus_cancel_organization_invite | Cancelar um convite pendente |
nexus_resend_organization_invite | Reenviar um e-mail de convite |
Chat Interno da Equipe
| Ferramenta | Descrição |
|---|
nexus_list_internal_conversations | Listar conversas internas do agente |
nexus_get_internal_messages | Obter mensagens em uma conversa |
nexus_open_internal_dm | Abrir um DM com um membro da organização |
nexus_send_internal_message | Enviar uma mensagem interna |
Inteligência de Conversa (CS AI)
| Ferramenta | Descrição |
|---|
nexus_list_ai_tag_definitions | Listar taxonomia de tags de IA |
nexus_list_message_annotations | Listar anotações de mensagens |
nexus_get_message_ai_annotation | Obter anotação para uma mensagem |
nexus_get_org_ai_annotation_settings | Obter configurações de IA da organização |
nexus_get_customer_conversation_intelligence | Obter perfil de inteligência do cliente |
nexus_get_conversation_intelligence_dashboard | Obter painel de análises de CS |
nexus_update_message_annotation | Atualizar uma anotação de mensagem |
nexus_update_ai_tag_definition | Atualizar uma definição de tag |
nexus_set_org_ai_annotation_prompt | Definir prompt de IA da organização |
nexus_update_org_conversation_intelligence_context | Atualizar contexto de IA da organização |
Recursos MCP
| Recurso | Descrição |
|---|
nexus://organization/info | Detalhes atuais da organização |
nexus://schema/contacts | Esquema do objeto de contato |
nexus://schema/orders | Esquema do objeto de pedido |
nexus://schema/inventory | Esquema do objeto de estoque |
nexus://schema/social | Esquema de postagem social |
nexus://schema/conversation-intelligence | Esquema de inteligência de conversa |
Preços
| Nível | Preço | Contatos | Pedidos | Mensagens | Escopos MCP |
|---|
| Free | $0 | 50 | 25 | 0 | leitura |
| Starter | $99/mo | 500 | 200/mo | 1,000 | leitura, escrita |
| Growth | $199/mo | 5,000 | ilimitado | 5,000 | completo |
| Scale | $599/mo | ilimitado | ilimitado | 20,000 | completo + suíte de IA |
Ferramentas sociais exigem o plano Starter ou superior. A suíte de inteligência de conversa com IA exige o plano Scale.
Skill do OpenClaw
Instale a skill do Nexus para agentes OpenClaw:
npx clawhub@latest install nexus
Ou instale manualmente copiando SKILL.md para o diretório de skills do seu workspace OpenClaw.
Documentação
Stack de Tecnologia
- Frontend: React 18 + TypeScript + Vite + Tailwind CSS + shadcn/ui
- Backend: Supabase (PostgreSQL + Edge Functions on Deno)
- Auth: Supabase Auth (JWT) with multi-tenant RLS
- MCP: Streamable HTTP transport