Draftbase
Servidor MCP remoto para Draftbase, un CMS headless nativo de MCP. 30 herramientas para plantillas, entradas, archivos multimedia, componentes MDX, revisiones y publicación programada. Es eficiente con el contexto: list_entries acepta una lista de campos, así que el agente solo obtiene las claves que necesita. Inicio de sesión con OAuth, sin necesidad de pegar una clave de API.
Servidor MCP alojado
npx add-mcp 'https://mcp.draftbase.co/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
MCP server
Draftbase exposes full template, entry, and media control as MCP tools — mirrors the REST API 1:1, so any MCP-capable client (Claude Code, Claude Desktop, etc.) can manage content directly.
Environments
| Env | MCP endpoint | API URL |
|---|---|---|
| staging | https://staging-mcp.draftbase.co/mcp | https://staging-api.draftbase.co |
| prod | https://mcp.draftbase.co/mcp | https://api.draftbase.co |
Auth
The server validates a Bearer JWT (aud: "mcp", sub = userId, orgId claim). Tokens are issued via standard OAuth 2.1 + PKCE with dynamic client registration. Discovery: GET <API_URL>/.well-known/oauth-authorization-server
Setup — Claude Code
claude mcp add --transport http draftbase-staging https://staging-mcp.draftbase.co/mcp
# prod: claude mcp add --transport http draftbase-prod https://mcp.draftbase.co/mcp
Then run /mcp in Claude Code — opens a browser to log in, completes OAuth, and stores the token. Run /mcp again to check connection status.
Setup — other MCP clients
Point the client at the MCP endpoint (<MCP_URL>/mcp) with transport: http. The client must support the OAuth 2.1 + PKCE discovery flow (dynamic client registration, no client secret). Without an OAuth-capable client, drive /oauth/register → /oauth/authorize → /oauth/token by hand against the API URL and set the resulting access_token as the Bearer token.
Tools
19 tools across 3 groups, matching the templates / entries / media REST routes.
Templates
list_templates | List all templates defined for the current org |
|---|---|
get_template | Get a single template by id, including its full field schema |
create_template | Create a template schema in one call — define all fields up front rather than creating then patching |
update_template | Update a template's name and/or fields (partial update — omit unchanged fields) |
delete_template | Delete a template. Fails if entries still reference it — delete those first |
Entries
list_entries | List entries, optionally filtered by template or locale. Returns MDX with reference/media fields resolved inline |
|---|---|
create_entry | Create a new content entry |
update_entry | Update an existing content entry |
get_entry | Get a single entry by id. Returns MDX with reference/media fields resolved inline |
delete_entry | Delete an entry permanently |
set_entry_status | Change an entry's status (draft, updated, published, archived) — publishing requires all required fields to be set |
list_entry_revisions | List an entry's revision history, newest first |
rollback_entry | Restore an entry's fields to a prior revision version |
Media
list_media | List uploaded media assets, optionally filtered by status |
|---|---|
get_upload_url | Get a presigned URL to upload a media asset. After uploading, call confirm_media with the returned storageKey to register it |
confirm_media | Register an uploaded media asset after it's been PUT to the presigned URL from get_upload_url |
replace_media | Swap an existing media asset's image (e.g. after re-cropping). Upload the new file to a presigned URL from get_upload_url first, then call this with the returned storageKey. Re-runs the resize pipeline |
set_media_tags | Replace a media asset's tags with the given list |
delete_media | Delete a media asset and its underlying stored object |