Documentation

Connect claude.ai

Add Inkrun to claude.ai (the web app) as a custom connector so Claude can render PDFs for you inside a conversation. Same remote MCP endpoint and OAuth flow as Claude Desktop — sign in once, no API key.

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

AvailabilityCustom connectors are configured in claude.ai Settings → Connectors. Depending on your Claude plan/organization, adding custom connectors may be gated to certain plans or require an admin to enable them.

Setup

1. Open connector settings

On claude.ai, go to Settings → Connectors → "Add custom connector".

Screenshotclaude.ai → Settings → Connectors, with "Add custom connector" highlighted.

2. Paste the Inkrun endpoint

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

url

https://inkrun.dev/api/mcp

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

3. Sign in to authorize

Claude opens Inkrun's login in your browser. Sign in once — Claude receives its own OAuth token; there's nothing to copy back.

ScreenshotThe Inkrun OAuth consent screen granting claude.ai access.

4. Enable the connector in a chat, then render

Start (or open) a conversation, make sure the Inkrun connector is enabled for it, and ask:

"Create a PDF from this markdown with the quarterly-report template: # Q2 Revenue … "

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

What Claude can do

The connector exposes the same tools as the desktop connector:

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.

See Templates → Charts for embedding charts in a render.

Troubleshooting

No "Add custom connector" option. Custom connectors may be limited by your plan or need an organization admin to turn them on. Check with your workspace admin.
Authorization fails / loops. Check 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. Re-run the OAuth sign-in so Claude holds a valid token for your account.
429 / quota exceeded. You've hit your monthly render quota — see quotas.

Not on claude.ai?

Claude Desktop → same OAuth connector, desktop steps.
Claude Code, ChatGPT, or another MCP client → Connect other clients.