{"_id":"@blueocean-os/mcp-server","_rev":"2-d3d6f435519f244f016b9f8da18fdc81","name":"@blueocean-os/mcp-server","dist-tags":{"latest":"0.4.0"},"versions":{"0.2.0":{"name":"@blueocean-os/mcp-server","version":"0.2.0","keywords":["mcp","claude-code","blue-ocean","intelligence-center","saas"],"license":"UNLICENSED","_id":"@blueocean-os/mcp-server@0.2.0","maintainers":[{"name":"paulonunan","email":"paulonunan.blueocean@gmail.com"}],"homepage":"https://app.blueoceanos.com","bugs":{"url":"https://github.com/ph-nunan/BlueOcean-OS/issues"},"bin":{"bo-mcp":"dist/index.js"},"dist":{"shasum":"fb27b62c09a730b77f2a90cb213e8baac0965dd2","tarball":"https://registry.npmjs.org/@blueocean-os/mcp-server/-/mcp-server-0.2.0.tgz","fileCount":3,"integrity":"sha512-V1/dtPjX14c8zkwhIfm8i8uzok1VEm7ZQLxjYb5tvQmXR0HcqojnFqb9KG8nTH2CFwcgzB1mDTT+8Gur6XL69A==","signatures":[{"sig":"MEUCIA+6mCIrYLmOuLP92Zw/MLmYcbkRFez3TvLD3ngSeeErAiEA34y5eHX8bVqk9YFNj0hPydqTcuR+RmhdY2LZU9JeIxU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23634},"main":"./dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"09bab39ca2bfc5a4508a669884a7cbcdca07aa90","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"paulonunan","email":"paulonunan.blueocean@gmail.com"},"repository":{"url":"git+https://github.com/ph-nunan/BlueOcean-OS.git","type":"git","directory":"bo-mcp-server"},"_npmVersion":"11.12.1","description":"MCP server pra Blue Ocean Intelligence Center — conecta Claude Code ao IC. Permissões herdadas do cargo do user (RBAC).","directories":{},"_nodeVersion":"24.15.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2","typescript":"^5.7.2","@types/node":"^22.10.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.2.0_1779059118826_0.6844319873772724","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@blueocean-os/mcp-server","version":"0.4.0","description":"MCP server pra Blue Ocean Intelligence Center — conecta Claude Code ao IC. Permissões herdadas do cargo do user (RBAC).","license":"UNLICENSED","type":"module","bin":{"bo-mcp":"dist/index.js"},"main":"./dist/index.js","scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4"},"devDependencies":{"@types/node":"^22.10.5","tsx":"^4.19.2","typescript":"^5.7.2"},"engines":{"node":">=18"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/ph-nunan/BlueOcean-OS.git","directory":"bo-mcp-server"},"homepage":"https://app.blueoceanos.com","keywords":["mcp","claude-code","blue-ocean","intelligence-center","saas"],"gitHead":"fc4736421ea4e1fe87458132dbdc82ebb95e58d0","_id":"@blueocean-os/mcp-server@0.4.0","bugs":{"url":"https://github.com/ph-nunan/BlueOcean-OS/issues"},"_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-Nxu+7z/fEl/VrlSXMXoD3cZeA7NuE4Ix/EQJBCheMCHBV/kOoSMkCD0Eimv9735k/408LBjmHWSwPP+ZOSxk2g==","shasum":"30e7d778376e7a8fd0128c7b1c52c2c0bb6b1e9a","tarball":"https://registry.npmjs.org/@blueocean-os/mcp-server/-/mcp-server-0.4.0.tgz","fileCount":3,"unpackedSize":28043,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCeOkeZQouRwqaD+g6va1K936uzHY0qDeLVGn1Q7QT/qAIhAImEcO50IvbewNiqrG2a4duygvumR5GTNOToZ+aWuw58"}]},"_npmUser":{"name":"paulonunan","email":"paulonunan.blueocean@gmail.com"},"directories":{},"maintainers":[{"name":"paulonunan","email":"paulonunan.blueocean@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.4.0_1782238483522_0.4814738068426909"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-17T23:05:18.767Z","modified":"2026-06-23T18:14:43.812Z","0.2.0":"2026-05-17T23:05:18.974Z","0.4.0":"2026-06-23T18:14:43.665Z"},"bugs":{"url":"https://github.com/ph-nunan/BlueOcean-OS/issues"},"license":"UNLICENSED","homepage":"https://app.blueoceanos.com","keywords":["mcp","claude-code","blue-ocean","intelligence-center","saas"],"repository":{"type":"git","url":"git+https://github.com/ph-nunan/BlueOcean-OS.git","directory":"bo-mcp-server"},"description":"MCP server pra Blue Ocean Intelligence Center — conecta Claude Code ao IC. Permissões herdadas do cargo do user (RBAC).","maintainers":[{"name":"paulonunan","email":"paulonunan.blueocean@gmail.com"}],"readme":"# @blueocean-os/mcp-server\n\nMCP server pra Blue Ocean Intelligence Center. Conecta Claude Code (Desktop, CLI, IDE) ao IC do funcionário, herdando permissões do cargo dele (RBAC).\n\n**Foco: leitura profunda + análise de dados.** 37 tools cobrindo clientes, tráfego, copy, designer, editor, CS, WhatsApp.\n\n---\n\n## Instalação ULTRA SIMPLES (1 comando)\n\n**Mac/Linux:**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/ph-nunan/BlueOcean-OS/master/bo-mcp-server/install.sh | bash\n```\n\n**Windows (PowerShell):**\n```powershell\nirm https://raw.githubusercontent.com/ph-nunan/BlueOcean-OS/master/bo-mcp-server/install.ps1 | iex\n```\n\nScript:\n1. Verifica Node 18+\n2. Pede seu token (cole quando perguntar)\n3. Faz backup do config Claude\n4. Adiciona entry `blue-ocean` automático\n5. Confirma sucesso\n\nDepois: **restart o Claude Desktop** (fecha completo e abre).\n\n**Pra pegar o token antes:**\n1. Login https://app.blueoceanos.com\n2. **Configurações → Tokens API**\n3. **\"Novo token\"** → cola no script quando pedir\n\n---\n\n## Bônus: contexto pro Claude (cola no chat 1x)\n\nManda esse arquivo pro Claude pra ele entender o sistema:\n[CONTEXTO-CLAUDE.md](./CONTEXTO-CLAUDE.md)\n\nOu 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.\n\n---\n\n## Caminho manual (se quiser)\n\n### 1. Pegar token\n\n1. Login em https://app.blueoceanos.com\n2. **Configurações → Tokens API**\n3. **\"Novo token\"** → nome (ex: \"Claude Desktop\")\n4. **Copie o token agora** (não verá de novo)\n\n### 2. Editar config Claude\n\nAbra:\n- **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Linux**: `~/.config/Claude/claude_desktop_config.json`\n\nCole:\n\n```json\n{\n  \"mcpServers\": {\n    \"blue-ocean\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@blueocean-os/mcp-server\"],\n      \"env\": {\n        \"BO_API_TOKEN\": \"bo_pat_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\nSubstitua `bo_pat_...` pelo seu token.\n\n### 3. Restart Claude\n\nFeche e abra. Pronto.\n\nPergunte em PT-BR:\n- \"Quais clientes do meu squad em risco de churn?\"\n- \"Resume análise CEO do cliente RCB\"\n- \"Mensagens negativas WhatsApp do Vigente últimos 7 dias\"\n- \"Performance Meta Ads do Mubisys últimas 14 dias\"\n- \"Tasks pendentes minhas\"\n\n---\n\n## Tools (37)\n\n**Squad** · `squad_overview`\n**Clientes** · `list_clientes` · `get_cliente_full` · `get_cliente_timeline` · `get_cliente_ingestions`\n**Tráfego** · `list_analises_trafego` · `get_analise_trafego` · `trafego_stats_squad` · `trafego_recentes`\n**Copy** · `list_copies` · `get_copy_lote` · `list_copy_pecas` · `copy_stats_squad`\n**Designer** · `list_designer_lotes` · `get_designer_historico` · `designer_stats_squad`\n**Editor** · `list_editor_lotes` · `get_editor_historico` · `editor_stats_squad`\n**CS IA-CEO** · `list_analises_ceo` · `get_analise_ceo`\n**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`\n**Tasks/Calendar** · `list_tasks` · `list_eventos` · `list_calendar_google`\n**Dashboards** · `dashboard_widgets` · `hoje_widgets` · `upsell_sugestoes`\n**Meta raw** · `meta_campaigns` · `meta_leads`\n\n---\n\n## Segurança\n\n- Token = permissões do seu cargo (não mais, não menos)\n- Squad scope: só dados do seu squad\n- Sem admin/sistema/criar squad\n- Audit log toda chamada\n- Revogue em **Configurações → Tokens API**\n\n---\n\n## Para admin Blue Ocean: Publicar npm\n\n### Setup inicial (1x)\n\n1. Conta npm corporativa\n2. Criar org: https://www.npmjs.com/org/create\n   - Nome: `blueocean`\n   - Plano: Free (público)\n3. Login:\n   ```bash\n   npm login\n   ```\n\n### Cada release\n\n```bash\ncd bo-mcp-server\nnpm version patch  # ou minor / major\nnpm publish\n```\n\n`prepublishOnly` builda automático.\n\nFuncionários usam `npx -y @blueocean-os/mcp-server` → puxa versão nova automático no próximo restart do Claude.\n\n### Variáveis\n\n- `BO_API_TOKEN` (obrigatório) — PAT do user\n- `BO_BASE_URL` (opcional) — default `https://app.blueoceanos.com`\n","readmeFilename":"README.md"}