Connect your workspace

Two short steps: add the connector to Claude, then install the plugin from the marketplace.

Where to do this

You can run these steps from Claude Cowork (claude.ai/code) or from Claude Code in your terminal. The connector is added once per Claude install; the plugin is added once per Cowork workspace or Claude Code session.

Step 1 — Generate a connector credential pair

Open Settings → API Keys & Connectors in your StorytellerOS dashboard. Scroll to the Claude Cowork Connectors card and click Generate credential pair.

You'll receive two values:

  • A client id starting with stcw_ (safe to keep, you can come back and see it later)
  • A client secret starting with stcs_ — shown only once. Copy it carefully into a password manager or directly into Cowork on the next step.

Lost the secret?

That's fine. Generate a new pair from the same card — you can have several active simultaneously. Revoke any pair you no longer need from the same place; each one is independent.

Step 2 — Add the connector in Claude

In Cowork (or Claude Desktop): Settings → Connectors → Add custom connector.

  • Name: StorytellerOS
  • Remote MCP server URL: https://storytelleros.com/api/mcp
  • Open Advanced settings and paste:
    • Client ID — the stcw_… value
    • Client Secret — the stcs_… value
  • Click Add.

Claude will redirect you to /authorizeon storytelleros.com — you may need to sign in if you aren't already, then you'll see the consent screen listing every pen name this connector will be able to address. Click Approve and Claude finishes the OAuth dance automatically. The stos_* tools become available immediately.

Which OAuth flow does this use?

Cowork performs OAuth 2.1 authorization_code + PKCE against /api/oauth/authorize and /api/oauth/token. We also support the client_credentials grant for direct headless callers (Make, Zapier, n8n). Both produce the same JWT, which the MCP endpoint and the /api/v1/* REST API accept identically.

Step 3 — Install the plugin (skills + slash commands)

In any Claude Code or Cowork session:

/plugin marketplace add https://github.com/chellehoniker/claude-code-storytelleros
/plugin install storytelleros@storytelleros

This adds the 28 conversational skills and the 7 /stos-*slash commands. The plugin doesn't bundle a connector — Step 2 already covered that — so the credential fields stay editable.

Step 4 — Smoke test

Try any of these in the Claude conversation:

  • /stos-task remember to email the cover designer — should confirm the task was captured.
  • “List my pen names” — should return your pen names with ids.
  • “What's on my task list for this week?” — runs the tasks skill.

If any of those return Invalid client credentials or 401, jump to Troubleshooting.

Prefer a simple API key?

If you're wiring up Make, Zapier, n8n, or a custom script (no Cowork connector flow needed), you can mint a direct API key from the same Settings → API Keys page. These start with stos_sk_ and work as Authorization: Bearer <key> on any /api/v1/* endpoint or /api/mcp call.

Multiple pen names?

The connector exposes every pen name on your account. Switch between them mid-conversation by saying “draft under my [pen name]” or “switch to [pen name]”. See the pen-names skill in the skills reference.