Getting started

Connect an agent

Connect Claude Code, Codex, Cursor or any MCP client to the Obelism Content MCP server, and let it model, write and publish content and set up a site.

2 min read

Obelism Content has an MCP server at https://content.obelism.studio/mcp. Its tools are the agent API: organizations and spaces, the content model, entries, assets, promotion, API tokens and webhooks. It signs in with OAuth, so there is no key to copy: the first time, your browser opens and you allow the connection. The dashboard's Agents page has the address and the Claude Code command, what an agent may do, and the apps connected to Content.

The Obelism plugin for Claude

In Claude Code, the Obelism plugin connects Content, improve and numbers at once, with skills for the jobs that span them: importing a page from Claude Design, connecting a site, and running an A/B test on a block.

/plugin marketplace add Obelism/sdk
/plugin install obelism@obelism

On claude.ai, an Organization Owner can add the same marketplace under Organization settings → Plugins. The plugin's source is in Obelism/sdk.

Let the agent set itself up

Paste this into your coding agent:

Fetch and follow the instructions to set me up for Obelism Content from https://content.obelism.studio/getting-started.md

The instructions there cover Claude Code, Codex, OpenCode, Cursor, VS Code, Windsurf and any other MCP client, and ask before touching your agent's instructions file. The dashboard's home page has the same prompt in a new space, ready to copy.

Or add it by hand

# Claude Code
claude mcp add --transport http --scope user obelism-content https://content.obelism.studio/mcp

# Codex
codex mcp add obelism-content --url https://content.obelism.studio/mcp
codex mcp login obelism-content

In Claude (web and desktop) and other apps with connectors, add a custom connector with the URL https://content.obelism.studio/mcp.

What it can do

The tools run as you, with your role in the organization: they can do no more than you can in the dashboard. A read-only grant gets only the reading tools. Disconnect an app under Connected apps on your Obelism account.

  • Model content: read the content types, change one, or plan and apply the whole model as a file.
  • Write content: create entries, save drafts, publish, move, restore a version, upload assets.
  • Start a site: getProjectSetup gives the npx @obelism/content init to run in the site's repository.
  • Connect a site in develop and staging: create a delivery or preview token, a webhook, send it a test and check it got a 2xx, and set the preview URL.

Note

In production, an agent can read tokens, webhooks and settings, but not create them: it tells you what to add under Settings instead. Token values and webhook secrets are shown once; an agent puts them in an untracked environment file and never repeats them.

For agents

On this page

Marks in the margin

  • Note
  • Watch out
  • Updated

Scribes marked doubtful lines in the margin. That practice is called obelism.

Stuck on a step?