How to connect ChatGPT or Claude to Boki
Connect ChatGPT or Claude to Boki using OAuth authentication
How to connect ChatGPT or Claude to Boki
Connect ChatGPT or Claude to your Boki workspace using OAuth. After connecting, the AI assistant can read and write your Boki content.
Overview
ChatGPT and Claude support MCP (Model Context Protocol) connections via OAuth. You add Boki as a custom connector in your AI client, complete the Boki sign-in, and the client can then access your workspace.
Boki MCP server URL: https://app.boki.io/api/mcp
Prerequisites
- A Boki account
- ChatGPT Plus, Team, or Enterprise (for custom connectors), or Claude Pro/Team/Enterprise
Connect from ChatGPT
ChatGPT lets you add custom MCP connectors. The exact menu location varies (Connectors, Apps, or Developer mode in Settings).
- In ChatGPT, go to Settings
- Find the option to add a custom connector or app
- Enter the Boki MCP URL:
https://app.boki.io/api/mcp - Save the connector
- When prompted, complete the Boki sign-in in the popup
- Authorize access to your workspace
After authorization, ChatGPT can use Boki tools in your conversations.
Connect from Claude
Personal accounts (Pro)
- In Claude, click Customize (or your profile)
- Go to Connectors
- Click Add custom connector
- Paste the URL:
https://app.boki.io/api/mcp - Click Add
- Complete the Boki sign-in when prompted
- Authorize access
Team or Enterprise accounts
For Team/Enterprise, an Owner adds the connector organization-wide first:
- Go to Organization settings → Connectors
- Click Add → Custom → Web
- Enter the URL:
https://app.boki.io/api/mcp - Save
Then each team member:
- Go to Connectors in their Claude settings
- Find Boki and click Connect
- Complete the Boki sign-in
What OAuth provides
After connecting:
- The AI client authenticates as your Boki user
- All operations use your permissions
- No token to copy or rotate — OAuth handles refresh automatically
Available tools
Once connected, the AI can access approximately 48 Boki tools:
| Scope | Operations |
|---|---|
| Articles | Read, create, update, delete, export |
| Briefs | Read, create, update, delete |
| Plans | Read, create, update, delete |
| Social posts | Read, create, update, delete |
| Distributions | Read, create, update, delete |
| Short links | Read, create, update, delete |
| Experts | Read, create, update, delete |
| Insights | Read, create, update, delete |
| Components | Create, delete MDX components |
| Workspace | Get context, brand voice |
OAuth vs personal access tokens
| Method | Best for | Token management |
|---|---|---|
| OAuth | ChatGPT, Claude | Automatic (no manual token) |
PAT (boki_pat_*) | Cursor, other MCP clients | Manual (generate, paste, rotate) |
Use OAuth for ChatGPT and Claude. Use personal access tokens for Cursor and clients that require a pasted token.
Result
After connecting:
- Ask ChatGPT or Claude to "list my Boki articles" or "create a brief about [topic]"
- The AI calls Boki tools on your behalf
- All changes appear in your Boki workspace
Troubleshooting
Sign-in popup doesn't appear: Check that popups are allowed for the AI client's domain.
Authorization fails: Ensure you're signing into the correct Boki account that has access to the workspace you want.
Tools not available: The connector may need a moment to sync. Try asking again or reconnecting.
Related
- How to generate an MCP token — For Cursor and PAT-based clients
- MCP tokens reference — Technical specification
- MCP client and server explained — Understanding MCP