{
  "id": "claude-desktop",
  "family": "Anthropic",
  "title": "Claude Desktop",
  "auth_method": "oauth",
  "origin": "vendor_cloud",
  "token_step": "OAuth sign-in bound to a PAT record: Front Door issues a JWT with the same claims as the PAT exchange.",
  "availability": {
    "status": "not_yet_available",
    "line": "Not yet available on PROD."
  },
  "environment": "production",
  "verified": false,
  "badge": "not yet available",
  "version": null,
  "released_at": null,
  "summary": "Remote MCP connector with OAuth sign-in bound to a PAT record. An interim local bridge (unverified) is on the page.",
  "client": "Claude Desktop",
  "html": "https://agents.a24labs.net/recipes/claude-desktop/",
  "json": "https://agents.a24labs.net/recipes/claude-desktop/recipe.json",
  "endpoints": {
    "hub": "https://agents.a24labs.net",
    "mcp": "https://edge.a24labs.net/mcp",
    "prm": "https://edge.a24labs.net/.well-known/oauth-protected-resource",
    "as_metadata": "https://id.a24labs.net/realms/a24labs/.well-known/openid-configuration",
    "auth_discovery": "https://edge.a24labs.net/discovery/v1/authentication",
    "bootstrap": "https://edge.a24labs.net/.well-known/awp-eeg",
    "token_endpoint": "https://frontdoor.a24labs.net/v1/oauth/token",
    "idp": "https://id.a24labs.net/realms/a24labs"
  },
  "planned_flow": [
    "Add `https://edge.a24labs.net/mcp` as a remote MCP connector in Claude Desktop.",
    "Claude follows the `401` challenge to the Protected Resource Metadata and the authorization server.",
    "You sign in through Front Door (authorization code + PKCE) and pick the PAT record the connection is bound to.",
    "Front Door issues a JWT with the same claims as the PAT exchange: one twin workspace, its capabilities, no org_admin. Revoking the PAT ends access."
  ],
  "token_script": "#!/bin/bash\n# awp-edge-token.sh — exchange an AWP PAT for a 15-minute Edge JWT. Prints the JWT only.\n# The PAT is read from a mode-600 file and sent on stdin, so it never appears in argv or history.\nset -euo pipefail\nPAT_FILE=\"${AWP_PAT_FILE:-$HOME/.config/awp/edge.pat}\"\nprintf '{\"grant_type\":\"urn:awp:params:oauth:grant-type:pat\",\"secret\":\"%s\"}' \"$(cat \"$PAT_FILE\")\" |\n  curl -sS --fail-with-body -X POST \"https://frontdoor.a24labs.net/v1/oauth/token\" \\\n    -H 'content-type: application/json' --data-binary @- |\n  python3 -c 'import json,sys; print(json.load(sys.stdin)[\"access_token\"])'",
  "token_response_example": "{\n  \"access_token\": \"<JWT>\",\n  \"token_type\": \"Bearer\",\n  \"expires_in\": 900,\n  \"scope\": \"...\"\n}",
  "interim": {
    "title": "Interim: local mcp-remote bridge",
    "summary": "A local workaround, not this card's flow: Claude Desktop starts mcp-remote on your machine, which carries a PAT-swap JWT to Edge. It uses the PAT exchange, so it works before OAuth sign-in is available. Beta until EEG, like the other Beta cards.",
    "config": [
      {
        "title": "Desktop config",
        "path": "~/Library/Application Support/Claude/claude_desktop_config.json",
        "lang": "json",
        "body": "{\n \"mcpServers\": {\n \"awp-edge\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-remote\", \"https://edge.a24labs.net/mcp\", \"--header\", \"Authorization:${AWP_EDGE_AUTH}\"],\n \"env\": { \"AWP_EDGE_AUTH\": \"Bearer <JWT from awp-edge-token.sh>\" }\n }\n }\n}"
      }
    ],
    "load_token": "Paste a fresh JWT into AWP_EDGE_AUTH and restart Claude Desktop. The JWT lasts 15 minutes, so this suits short sessions; Claude Code's headers helper is the better fit for long ones.",
    "notes": [
      "Write `Authorization:${AWP_EDGE_AUTH}` with no space after the colon; the value carries the space after `Bearer`."
    ]
  },
  "prompts": [
    {
      "prompt": "List the tools the awp-edge MCP server exposes.",
      "expect": "5 tools on this Edge (fewer if your PAT lacks a capability)."
    },
    {
      "tool": "discovery",
      "prompt": "Call the awp-edge tool discovery with limit 5 and list the resource ids it returns.",
      "expect": "Up to five resources labelled STORE (evidence.source=awp-store)."
    },
    {
      "tool": "workspace_search",
      "prompt": "Call workspace_search with query \"agents hub\" and limit 5.",
      "expect": "Up to five STORE results."
    },
    {
      "tool": "project_query",
      "prompt": "Call project_query with {\"id\": \"<project-id>\"}. Use id only; free-text query is unsupported.",
      "expect": "One project, or a clear bad-args error if you pass query."
    }
  ]
}
