Skip to content

Fix the Claude Code MCP server and sync general skills for 0.5.0 - #12

Draft
bitpshr wants to merge 4 commits into
mainfrom
paul/one-command-setup-plugin
Draft

bitpshr wants to merge 4 commits into
mainfrom
paul/one-command-setup-plugin

Conversation

@bitpshr

@bitpshr bitpshr commented Nov 13, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Claude Code installs this plugin but drops the hosted MCP server: mcp.json has a url and Cursor's auth block but no type, so Claude Code reads it as a stdio server and discards it. claude plugin validate fails on main with that. The copied skills are also about five weeks old and missing onboarding and realtime.

This should merge, and 0.5.0 should be on the marketplace, before elevenlabs/cli#191 (elevenlabs/cli#191) is released. Its elevenlabs setup tells Claude Code users they get the hosted MCP server, which is only true with this change.

fwiw, the copied onboarding skill's list of next values doesn't mention offer_setup, which that CLI PR adds. Agents follow the reply's instruction text, so nothing breaks; the skill can be updated in elevenlabs/skills later.

Part of https://linear.app/elevenlabs/project/one-command-setup-a4c48e749ad8/overview (G-331).

Testing

Run in throwaway CLAUDE_CONFIG_DIR / CODEX_HOME folders, with Claude Code 2.1.303 and 2.1.321 and Codex CLI 0.167.1:

  • claude plugin validate . and claude plugin validate .claude-plugin/plugin.json exit 0 here and 1 on main.
  • After installing from a checkout of this branch, claude mcp list shows plugin:elevenlabs:elevenlabs: https://api.us.elevenlabs.io/v1/mcp (HTTP) - ! Needs authentication; on main it shows No MCP servers configured. claude plugin details lists onboarding and realtime.
  • diff -rq against elevenlabs/skills@0c3ce60 shows no difference in the skill folders.
  • Codex: after adding the marketplace and the plugin, codex mcp list still shows the hosted server, at 0.5.0.
  • Upgrading an installed 0.4.0 to 0.5.0 works in both: claude plugin marketplace update then claude plugin update, and codex plugin add again. The server shows up in claude mcp list afterwards.
  • mcp.json, .codex-plugin/mcp.json, skills/mcp/, architect/, server.json and marketplace.json are unchanged; .cursor-plugin/plugin.json only changes version.

Not checked:

  • Cursor, which has no command-line install. Its files only change the version.
  • Signing in to the hosted MCP from Claude Code or Codex, which needs a real account in a browser. Both stop at "Needs authentication" / "Not logged in".
  • The upgrade from the GitHub marketplace, since this branch isn't on main yet.

There are no automated tests or CI in this repo.

Before and after, claude plugin validate .:

validate

Before and after, claude mcp list:

mcp list

Claude Code drops an HTTP server whose entry has a url but no type, so
the shared mcp.json (written for Cursor) left Claude Code with no
ElevenLabs MCP server and made claude plugin validate fail. Point the
Claude manifest at .claude-plugin/mcp.json with type http, as PR #11
did for Codex. mcp.json stays as Cursor reads it.

Bump the version to 0.5.0 in all three manifests so installed copies
update.
Copy skills/general 1:1 from elevenlabs/skills@0c3ce60. This adds the
onboarding skill (sign-in, API key, SDK and a first request) and the
realtime skill (ElevenLabs Realtime models and migrating from OpenAI
Realtime), and picks up the changelog updates from 2026-10-05 to
2026-11-02, the structured procedure guidance, fixed speech-to-text
realtime Python examples, the retired-voice and free-plan voice limit
notes, and the agents skill's corrected CLI steps after onboarding.
Add the two skills the sync brought in to the general skills table, and
say which MCP config file each agent reads now that Claude Code has its
own.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant