Connect an agent

PDFox runs a remote MCP server at https://api.pdf-fox.com/mcp. Add that URL to any MCP client that supports remote (Streamable HTTP) servers with OAuth. There is nothing to install and no API key to paste.

/mcp accepts OAuth access tokens only. PDFox API keys (pdfs_…) are rejected with 401. Use API keys with the REST API instead.

How the connection works

Add the server URL

Paste https://api.pdf-fox.com/mcp into your client. It discovers PDFox's OAuth settings from /.well-known/oauth-protected-resource and registers itself (dynamic client registration or a client ID metadata document).

Approve in PDFox

The client opens the PDFox consent screen (PKCE S256). Sign in, choose the organisation to connect, review the requested scopes, and approve.

Use the tools

The client receives an access token (valid 1 hour) and a refresh token, then calls PDFox tools for that organisation. Ask it to "list my PDFox templates" to check.

Who can connect

Owners, admins, editors, and billing admins can connect an agent. Viewers cannot. Only owners and admins can grant the write scopes (template:write, document:create, asset:write), which most clients request by default.

You get what your role can grant. If an editor or billing admin approves a client that asks for write access, PDFox connects it with the read scopes only (template:read, document:read, usage:read, asset:read). The consent screen marks the left-out permissions as "Not included" before you approve, and the token's scope lists only what was granted. Refreshing the token never adds scopes, so for full access an owner or admin connects the app, or you reconnect after being promoted. Roles are re-checked on every request, so a demoted member's connection loses write access immediately.

Revoke a connection at any time under Account → API Keys → Connected apps.

Claude

In Claude, go to Customize → Connectors, click +, then Add custom connector. Name it PDFox, paste the MCP URL, add it, then click Connect to approve PDFox OAuth.

Cursor

Add the server to .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally). Cursor opens the PDFox consent screen the first time it connects.

VS Code (GitHub Copilot)

Add the server to .vscode/mcp.json in your workspace. VS Code prompts you to authorise PDFox when the server starts.

For step-by-step screenshots for Claude and ChatGPT, and a copy button for the MCP URL, see Developer → MCP Connectors in the dashboard.

Name: PDFox
Remote MCP server URL: https://api.pdf-fox.com/mcp

{
  "mcpServers": {
    "pdfox": {
      "url": "https://api.pdf-fox.com/mcp"
    }
  }
}

{
  "servers": {
    "pdfox": {
      "type": "http",
      "url": "https://api.pdf-fox.com/mcp"
    }
  }
}