Claude (desktop & web)

Claude web/desktop connectors reach Pagelet's open tools; full publish access needs the Desktop bridge below.

Web / desktop custom connector (open tools only)

Claude's custom connectors accept a remote MCP URL, with Advanced settings offering only an OAuth Client ID and Secret — there is no field for a static bearer token, and Pagelet doesn't use OAuth. Connect without auth and you get the open tools (discovery, get_capabilities); token-gated tools answer "Auth required".

1. Go to Customize → Connectors (Team/Enterprise: an Owner adds it under Organization settings → Connectors first).
2. Click + → Add custom connector.
3. Enter https://pagelet.link/mcp, leave Advanced settings empty, click Add.
4. Enable it per conversation via + → Connectors.

Claude Desktop: full access via a local bridge

Claude Desktop also runs local MCP servers, which can set arbitrary headers. Themcp-remote bridge turns Pagelet's remote endpoint into a local stdio server with your token attached — this is the pattern Pagelet's own pagelet://connect resource recommends. Register a token (one curl call), then edit claude_desktop_config.json(macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "pagelet": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://pagelet.link/mcp",
        "--header", "Authorization: Bearer ${PAGELET_TOKEN}"
      ],
      "env": { "PAGELET_TOKEN": "pgl_…" }
    }
  }
}

Restart Claude Desktop fully (quit and relaunch) after editing.

Verify it works

• Click + in the chat box → Connectors — pagelet and its tools are listed.
• Settings → Developer shows each local server's connection status and logs.
• Ask: "List my pagelets." With the bridge, list_pagelets answers; with the web connector it returns an auth error (expected).

First pagelet

With the bridge configured, ask: "Make a pagelet of my meeting notes and publish it." Claude callspublish_pagelet and returns a https://<slug>.usepagelet.com URL — open it to confirm.

Troubleshooting

• Bridge server won't start — needs Node.js/npx on your PATH; check the Developer settings logs for the spawn error.
• "Auth required" on publish — the token in env.PAGELET_TOKEN is wrong or the header arg was edited; the string must be exactly Authorization: Bearer pgl_….
• Connector works on web but not desktop (or vice versa) — custom connectors sync via your account but require public reachability from Anthropic's IPs; local bridges run from your machine and don't.
• No tools at all — check /api/capabilities for service.mcp.

Sources: Custom connectors (remote MCP) andLocal MCP servers on Claude Desktop.