strateegia-mcp

Remote MCP server that exposes the Strateegia Projects API to MCP clients (Claude.ai, Claude Desktop, Cursor, ChatGPT, etc.).

Runs on Cloudflare Workers. Stateless — the user's Strateegia API key is passed through on every request, never stored.

v1 Tools

Tool	Description
`list_projects`	List user's projects (paginated)
`get_project`	Full project details with members and maps
`create_project`	Create a project in a lab
`list_maps_in_project`	List journey maps in a project
`get_map`	Full map with all points and structure
`create_divergence_point`	Collect ideas/responses (brainstorming)
`create_convergence_point`	Group decision-making via polls
`create_essay_point`	Long-form text with optional peer evaluation
`create_monitor_point`	Track qualitative or quantitative progress
`add_comment_to_question`	Add a response to a divergence question
`like_comment`	Like (curtir) a response in a divergence point
`unlike_comment`	Remove a previously given like on a response
`reply_to_comment`	Reply to an existing response (nested comment)

Development

npm install
npm run dev

This starts Wrangler dev server at http://localhost:8787. The MCP endpoint is /mcp.

Testing with MCP Inspector

npx @modelcontextprotocol/inspector

Enter http://localhost:8787/mcp as the server URL. Add an Authorization: Bearer <your_strateegia_api_key> header.

Deploy

npx wrangler deploy

Your MCP server will be available at https://strateegia-mcp.<your-account>.workers.dev/mcp.

Build the `.mcpb` bundle

npm run mcpb:pack

Output: strateegia.mcpb na raiz do projeto. Pode ser anexado em uma GitHub Release e baixado pelos usuários. Para mudar o Worker URL apontado pelo bundle, edite a entrada em server.mcp_config.args de mcpb/manifest.json antes de empacotar.

Client Configuration

Claude.ai (Web)

Settings > Connectors > Add custom connector:

URL: https://strateegia-mcp.<your-account>.workers.dev/mcp
Add header: Authorization: Bearer <your_strateegia_api_key>

Cursor / Claude Code (mcp.json)

These clients support remote MCP servers with url + headers directly:

{
  "mcpServers": {
    "strateegia": {
      "url": "https://strateegia-mcp.<your-account>.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer <your_strateegia_api_key>"
      }
    }
  }
}

Claude Desktop — Extensão `.mcpb` (recomendado)

Instalação sem editar JSON. Ideal para usuário leigo.

Baixe o arquivo strateegia.mcpb mais recente (ver Releases ou gere localmente com npm run mcpb:pack)
Dê duplo clique — o Claude Desktop abre a tela de instalação
Cole sua API key do Strateegia (gere em https://app.strateegia.digital → Configurações → API Keys)
Clique em "Instalar". Pronto.

Requer Claude Desktop ≥ 0.10.0.

Claude Desktop — manual (claude_desktop_config.json)

Alternativa sem a extensão. Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "strateegia": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://strateegia-mcp.<your-account>.workers.dev/mcp",
        "--header",
        "Authorization: Bearer <your_strateegia_api_key>"
      ]
    }
  }
}

Other stdio-only clients

Any client that only supports stdio transport can use the same mcp-remote approach shown above.

Auth Model

The user provides their Strateegia API key (PAT) as a Bearer token. The worker:

Extracts Authorization: Bearer <api_key> from each request
Rejects with 401 if missing
Exchanges the API key for a JWT via POST /users/v1/auth/api
Uses the JWT to call the Strateegia Projects API
Propagates any 401/403/422/429 errors from the API

No credentials are stored. The JWT is ephemeral — it only exists during the request lifecycle. If the API key is revoked in Strateegia, it stops working here automatically.