Skip to content

Latest commit

 

History

History
68 lines (45 loc) · 2.15 KB

MCP_QUICKSTART.md

File metadata and controls

68 lines (45 loc) · 2.15 KB

AgentStack MCP Quick Start for Claude Code

Interactive setup: agentstack.tech/mcp-docs#clients?client=claude

Catalog SoT: live GET /mcp/actions via one tool — agentstack.execute (no hard-coded action counts).

Preferred: plugin remote server

Installing the plugin registers .mcp.json:

Field Value
Transport HTTP (type: http, Streamable HTTP)
URL https://agentstack.tech/mcp

A url without type is read as a local stdio server and skipped. This file sets type. It does not set an Authorization header, so Claude can start OAuth when the server returns 401.

After install:

claude mcp list
/mcp

Sign in in the browser when Claude asks. The same OAuth server is used by ChatGPT (/mcp/.well-known/oauth-register).

Fallback: Device Code bearer

Use this when the browser OAuth prompt is unavailable. A configured Authorization header does not start Claude's OAuth flow.

node scripts/device-login.mjs --scope-preset=full

Approve in the browser, then run the printed command (or /agentstack:login):

claude mcp add agentstack --transport http https://agentstack.tech/mcp \
  --header "Authorization: Bearer <access_token>" \
  --header "Content-Type: application/json"

Fallback: API key

Create an anonymous project/API key (see shared MCP_QUICKSTART):

claude mcp add agentstack --transport http https://agentstack.tech/mcp \
  --header "X-API-Key: <agentstack_api_key>" \
  --header "Content-Type: application/json"

Verify

claude mcp list
/mcp

Smoke in chat: ask Claude to list projects via agentstack.execute / projects.get_projects.

Recovery

  • authorization_pending — keep polling (not an error).
  • 401 / MCP missing — re-run device-login.mjs or /agentstack:login.
  • service_caps_required_in_prod — use --scope-preset=full.

Canonical shared docs: docs/plugins/MCP_QUICKSTART.md.