@blueocean-os/mcp-server

MCP server pra Blue Ocean Intelligence Center. Conecta Claude Code (Desktop, CLI, IDE) ao IC do funcionário, herdando permissões do cargo dele (RBAC).

Foco: leitura profunda + análise de dados. 37 tools cobrindo clientes, tráfego, copy, designer, editor, CS, WhatsApp.

Instalação ULTRA SIMPLES (1 comando)

Mac/Linux:

curl -fsSL https://raw.githubusercontent.com/ph-nunan/BlueOcean-OS/master/bo-mcp-server/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/ph-nunan/BlueOcean-OS/master/bo-mcp-server/install.ps1 | iex

Script:

1. Verifica Node 18+
2. Pede seu token (cole quando perguntar)
3. Faz backup do config Claude
4. Adiciona entry blue-ocean automático
5. Confirma sucesso

Depois: restart o Claude Desktop (fecha completo e abre).

Pra pegar o token antes:

1. Login https://app.blueoceanos.com
2. Configurações → Tokens API
3. "Novo token" → cola no script quando pedir

Bônus: contexto pro Claude (cola no chat 1x)

Manda esse arquivo pro Claude pra ele entender o sistema: CONTEXTO-CLAUDE.md

Ou diga no Claude: "leia o contexto Blue Ocean" e cole o conteúdo dele. Claude internaliza tudo (37 tools, RBAC, padrões de uso) e fica muito mais útil.

Caminho manual (se quiser)

1. Pegar token

1. Login em https://app.blueoceanos.com
2. Configurações → Tokens API
3. "Novo token" → nome (ex: "Claude Desktop")
4. Copie o token agora (não verá de novo)

2. Editar config Claude

Abra:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Cole:

{
  "mcpServers": {
    "blue-ocean": {
      "command": "npx",
      "args": ["-y", "@blueocean-os/mcp-server"],
      "env": {
        "BO_API_TOKEN": "bo_pat_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Substitua bo_pat_... pelo seu token.

3. Restart Claude

Feche e abra. Pronto.

Pergunte em PT-BR:

• "Quais clientes do meu squad em risco de churn?"
• "Resume análise CEO do cliente RCB"
• "Mensagens negativas WhatsApp do Vigente últimos 7 dias"
• "Performance Meta Ads do Mubisys últimas 14 dias"
• "Tasks pendentes minhas"

Tools (37)

Squad · squad_overview Clientes · list_clientes · get_cliente_full · get_cliente_timeline · get_cliente_ingestions Tráfego · list_analises_trafego · get_analise_trafego · trafego_stats_squad · trafego_recentes Copy · list_copies · get_copy_lote · list_copy_pecas · copy_stats_squad Designer · list_designer_lotes · get_designer_historico · designer_stats_squad Editor · list_editor_lotes · get_editor_historico · editor_stats_squad CS IA-CEO · list_analises_ceo · get_analise_ceo WhatsApp · list_wa_messages · get_wa_stats · get_wa_heatmap · get_wa_sla · get_wa_risks · get_wa_alertas_grupo · get_wa_bigdata · get_wa_insights · list_wa_groups Tasks/Calendar · list_tasks · list_eventos · list_calendar_google Dashboards · dashboard_widgets · hoje_widgets · upsell_sugestoes Meta raw · meta_campaigns · meta_leads

Segurança

• Token = permissões do seu cargo (não mais, não menos)
• Squad scope: só dados do seu squad
• Sem admin/sistema/criar squad
• Audit log toda chamada
• Revogue em Configurações → Tokens API

Para admin Blue Ocean: Publicar npm

Setup inicial (1x)

1. Conta npm corporativa
2. Criar org: https://www.npmjs.com/org/create
   • Nome: blueocean
   • Plano: Free (público)
3. Login:

   npm login

Cada release

cd bo-mcp-server
npm version patch  # ou minor / major
npm publish

prepublishOnly builda automático.

Funcionários usam npx -y @blueocean-os/mcp-server → puxa versão nova automático no próximo restart do Claude.

Variáveis

• BO_API_TOKEN (obrigatório) — PAT do user
• BO_BASE_URL (opcional) — default https://app.blueoceanos.com