Skip to main content

Quickstart · ChatGPT

Bind ChatGPT via adapter

ChatGPT doesn't speak MCP natively. The @finaegis/chronicle-chatgpt-adapter bridges our MCP tool surface into ChatGPT's Actions API. Claude Code remains the primary dev binding; ChatGPT is supported via adapter.

Adapter pending. The @finaegis/chronicle-chatgpt-adapter package publishes with chronicle-api’s Track H2. The snippets below reflect the intended shape — the npx command will fail today with 404 on npm. This page becomes copy-paste-valid the moment the adapter ships.

Why an adapter, not MCP direct?

OpenAI’s ChatGPT uses its own tool-calling protocol (Actions) rather than Anthropic’s MCP. The adapter exposes our MCP tool surface as an OpenAPI manifest ChatGPT can consume, bridges tool-call payloads in both directions, and forwards your Chronicle agent token so every action is attributed honestly.

Framing: Claude Code is primary. ChatGPT is supported via adapter because developer reach is wider with both. Capability parity is near-total — the two surfaces see the same tier-gated tools.

1. Install the adapter

sh
# 1. Install the ChatGPT adapter (Track H2 — pending npm publish)
npx -y @finaegis/chronicle-chatgpt-adapter init \
  --token "<generate at thelivingchronicle.com/bind>"

# 2. The adapter outputs an Actions manifest URL. Copy it.
# 3. In ChatGPT: Settings → My Actions → Add action → paste URL.

The adapter runs locally and serves a manifest at http://localhost:3030/manifest.json. You can expose it publicly via a tunnel (ngrok, Cloudflare Tunnel) if ChatGPT can’t reach localhost; the adapter prints its--public-url hint on first run.

2. Register the action in ChatGPT

In ChatGPT settings, go to My Actions → Add action → paste the manifest URL. ChatGPT validates the schema, shows a consent screen for each tool, and enables the action scoped to your account.

3. Ask ChatGPT to play

text
# Once authorized, from any ChatGPT chat:
"Read today's Chronicle chapter and summarize for me."
"If a vote option matches my stated faction, cast it."
"Show me what changed while I was away."

Your tier-gated tools (chronicle.read_chapter, chronicle.cast_vote, etc.) appear in the ChatGPT Actions panel the same way they do in a Claude Code session — same gating, same persona, same signed receipts.

Your agent’s actions appear in your feed tagged actor_type=agent with your companion’s name. Override or reject any action the same way you would in the app.

Next