Documentation

Connect Claude Desktop

Add Inkrun to Claude Desktop as a custom connector and Claude can render PDFs for you directly in a chat — attributed to your account and counted against your quota.

This uses Inkrun's remote MCP endpoint over OAuth: you sign in once in the browser and Claude gets its own token. No API key to copy or rotate.

The endpoint is https://inkrun.dev/api/mcp. You can copy it from the dashboard under API & MCP → Connect Claude.

Setup

1. Open Claude's connector settings

In Claude Desktop, go to Settings → Connectors → "Add custom connector".

ScreenshotClaude Desktop → Settings → Connectors, with the "Add custom connector" button highlighted.

2. Paste the Inkrun endpoint

Name it Inkrun and use your deployment's MCP URL as the server URL:

url

https://inkrun.dev/api/mcp

ScreenshotThe "Add custom connector" dialog with Name = "Inkrun" and the …/api/mcp URL filled in.

3. Sign in to authorize

Claude opens your browser on Inkrun's login. Sign in once — Claude receives its own OAuth token. Nothing to paste back into Claude.

ScreenshotThe Inkrun OAuth consent screen ("Authorize Claude to access your Inkrun account") after signing in.

4. Render from a chat

Ask Claude to make a PDF. For example:

"Create a PDF from this markdown with the sales-proposal template: # Proposal for Acme … "

The render appears in your History (https://inkrun.dev/history), counted against your quota, and Claude replies with a presigned download link.

What Claude can do

The connector exposes these tools:

Tool	What it does
`create_pdf`	Render Markdown → themed PDF, store it, return a download URL. Accepts `template`, `theme`, `format`, `title` — plus `sendEmailTo` + `senderName` (and optional `emailMessage`) to email the PDF to someone as a branded download link valid for 3 days (paid plans — on the free tier the PDF still renders, but the email is skipped with a notice).
`list_templates`	List your saved templates plus the built-ins.
`create_template`	Create a reusable style option (theme + accent + fonts + format).
`get_styles`	Return a theme's CSS + page config.
`get_chart_syntax`	Explain the `chart` fenced-block syntax for embedding charts.

Charts work inside create_pdf: include a ```chart block in the Markdown. See Templates → Charts.

Troubleshooting

The connector won't authorize. Confirm the URL is exactly https://inkrun.dev/api/mcp, then remove and re-add the connector and sign in again.
create_pdf says an account is required. The tool only stores renders for an authenticated account. Re-run the OAuth sign-in (step 3).
Renders 429 / quota exceeded. You've hit your monthly render quota. See quotas.
No download URL returned. S3 storage isn't configured on that deployment; the render still succeeds but there's no presigned link.

Not using Claude Desktop?

Claude Code, ChatGPT, Cursor, and any other MCP client can connect too — over OAuth, or with an API key sent as a header. See Connect other clients.