Nexus-mcp-server

Sistema operacional Ops nativo de agente para ecommerce e varejo — CRM, pedidos, inventário, fulfillment, envio, mensagens omnichannel e análises de IA. Tudo através de uma única conexão MCP.

Documentação

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.

MCP License

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

FerramentaDescrição
nexus_list_contactsListar/pesquisar contatos com filtros
nexus_get_contactObter detalhes completos do contato
nexus_create_contactCriar um novo contato
nexus_update_contactAtualizar campos do contato

Pedidos

FerramentaDescrição
nexus_list_ordersListar pedidos com filtros
nexus_get_orderObter pedido com itens de linha
nexus_create_orderCriar pedido com itens de linha
nexus_update_order_statusMover pedido pelo ciclo de vida

Estoque

FerramentaDescrição
nexus_list_inventoryListar itens de estoque
nexus_check_stockVerificar estoque para item/SKU

Mensagens

FerramentaDescrição
nexus_list_conversationsListar conversas omnichannel
nexus_send_messageEnviar via WhatsApp/FB/IG
nexus_searchPesquisa global em todos os dados

Social

FerramentaDescrição
nexus_sync_social_postsSincronizar postagens de contas conectadas
nexus_list_social_postsListar postagens sociais
nexus_get_social_postObter uma única postagem
nexus_create_social_postCriar uma postagem de rascunho
nexus_update_social_postAtualizar uma postagem de rascunho
nexus_publish_social_postPublicar uma postagem
nexus_delete_social_postExcluir uma postagem
nexus_list_social_accountsListar contas sociais conectadas
nexus_get_social_analyticsObter análises sociais
nexus_get_content_calendarObter calendário de conteúdo agendado

Organização

FerramentaDescrição
nexus_list_organization_invitesListar convites pendentes
nexus_invite_organization_memberConvidar um novo membro
nexus_cancel_organization_inviteCancelar um convite pendente
nexus_resend_organization_inviteReenviar um e-mail de convite

Chat Interno da Equipe

FerramentaDescrição
nexus_list_internal_conversationsListar conversas internas do agente
nexus_get_internal_messagesObter mensagens em uma conversa
nexus_open_internal_dmAbrir um DM com um membro da organização
nexus_send_internal_messageEnviar uma mensagem interna

Inteligência de Conversa (CS AI)

FerramentaDescrição
nexus_list_ai_tag_definitionsListar taxonomia de tags de IA
nexus_list_message_annotationsListar anotações de mensagens
nexus_get_message_ai_annotationObter anotação para uma mensagem
nexus_get_org_ai_annotation_settingsObter configurações de IA da organização
nexus_get_customer_conversation_intelligenceObter perfil de inteligência do cliente
nexus_get_conversation_intelligence_dashboardObter painel de análises de CS
nexus_update_message_annotationAtualizar uma anotação de mensagem
nexus_update_ai_tag_definitionAtualizar uma definição de tag
nexus_set_org_ai_annotation_promptDefinir prompt de IA da organização
nexus_update_org_conversation_intelligence_contextAtualizar contexto de IA da organização

Recursos MCP

RecursoDescrição
nexus://organization/infoDetalhes atuais da organização
nexus://schema/contactsEsquema do objeto de contato
nexus://schema/ordersEsquema do objeto de pedido
nexus://schema/inventoryEsquema do objeto de estoque
nexus://schema/socialEsquema de postagem social
nexus://schema/conversation-intelligenceEsquema de inteligência de conversa

Preços

NívelPreçoContatosPedidosMensagensEscopos MCP
Free$050250leitura
Starter$99/mo500200/mo1,000leitura, escrita
Growth$199/mo5,000ilimitado5,000completo
Scale$599/moilimitadoilimitado20,000completo + 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