Pulse MCP Server

Servidor Model Context Protocol para consultar telemetria Pulse e anotar eventos via IA (Cursor, Claude Desktop, etc.).

Package público no npm: @softpulse/pulse-mcp-server.
A API é remota (https://pulse-api.orkestraai.com.br).
O MCP no Cursor é um client leve (stdio) que chama essa API com a sua pulse_live_….

Não substitui ingest de alto volume — use a Ingest API v1 ou SDKs.
Escopo produto: orkestra-pulse/docs/MCP-V1.md.

Tools

| Tool | Descrição | |------|-----------| | pulse_overview | KPIs do workspace (minutes opcional) | | pulse_query_logs | Logs (limit, minutes, level, service) | | pulse_query_traces | Traces/spans (limit, minutes) | | pulse_annotate | Anotação via ingest de logs |

Variáveis

| Variável | Uso | |----------|-----| | PULSE_API_URL | Base da API (default produção) | | PULSE_WORKSPACE_ID | Workspace | | PULSE_API_KEY | pulse_live_… — leitura MCP + anotações |

Publicar

npm login
cd mcp/pulse-server
npm publish --access public

Cursor / Claude Desktop

{
  "mcpServers": {
    "pulse": {
      "command": "npx",
      "args": ["-y", "@softpulse/pulse-mcp-server"],
      "env": {
        "PULSE_API_URL": "https://pulse-api.orkestraai.com.br",
        "PULSE_WORKSPACE_ID": "seu-workspace-id",
        "PULSE_API_KEY": "pulse_live_…"
      }
    }
  }
}

No console Pulse: Integrações → MCP gera o snippet com workspace e chave.

Dev local (opcional)

cd mcp/pulse-server
npm install
npm run build
npm link

{
  "mcpServers": {
    "pulse": {
      "command": "pulse-mcp",
      "env": {
        "PULSE_API_URL": "https://pulse-api.orkestraai.com.br",
        "PULSE_WORKSPACE_ID": "seu-workspace-id",
        "PULSE_API_KEY": "pulse_live_…"
      }
    }
  }
}