Skip to content

Add portable mcp.json using ActiveCampaign's shared MCP endpoint - #2

Open
shayhowe wants to merge 1 commit into
agent-plugins-standardfrom
portable-mcp-json
Open

Add portable mcp.json using ActiveCampaign's shared MCP endpoint#2
shayhowe wants to merge 1 commit into
agent-plugins-standardfrom
portable-mcp-json

Conversation

@shayhowe

@shayhowe shayhowe commented Aug 7, 2026

Copy link
Copy Markdown

Summary

Stacked on #1. The shared MCP endpoint https://mcp.app-us1.com/http removes the per-account-URL blocker that kept a portable mcp.json out of the initial Agent Plugins adoption — OAuth links the connection to the user's account, so a fixed URL works for every install.

  • New root mcp.json (Agent Plugins v1.0.0 MCP config): one streamable-http server entry pointing at the shared endpoint. Agent Plugins-compatible clients now get the MCP connection automatically at install.
  • README: the compatibility matrix now marks the MCP connection portable; a new "Agent Plugins-compatible clients" setup path (install and you're done); the manual Cursor/Codex snippets switch from the per-account URL to the shared endpoint (per-account URL still documented as an alternative).
  • CHANGELOG: portable mcp.json recorded under the unreleased 0.3.0; the now-obsolete "no portable mcp.json" note removed.

Claude Code is unchanged — it keeps collecting the per-account URL via userConfig/.mcp.json. Possible follow-up: switch Claude Code's .mcp.json to the shared endpoint too and drop userConfig, which would remove the URL prompt from Claude installs. Left out of this PR since it changes existing-install behavior.

Validation

  • mcp.json validated against the published mcp.schema.json (required $schema const, streamable-http required/allowed fields, no extra properties), and its spec version confirmed to match plugin.json (the spec requires this, else clients must disable MCP).
  • Endpoint sanity-checked live: an unauthenticated MCP initialize POST returns HTTP 401, the expected challenge from an OAuth-protected MCP server.

Merge order

Merge #1 first; this PR's base is agent-plugins-standard and GitHub will retarget it to main automatically when #1 merges and its branch is deleted.

🤖 Generated with Claude Code

The shared endpoint https://mcp.app-us1.com/http removes the
per-account-URL blocker that kept mcp.json out of the initial Agent
Plugins adoption: OAuth links the connection to the user's account, so
a fixed URL now works for every install.

- Add root mcp.json (Agent Plugins v1.0.0 MCP config, streamable-http),
  validated against the published schema; endpoint verified live
  (returns 401 challenge, as expected for OAuth-protected MCP).
- README: mark the MCP connection portable in the compatibility matrix,
  add an Agent Plugins-client setup path (zero manual MCP config), and
  switch the Cursor/Codex manual snippets to the shared endpoint.
- CHANGELOG: record the portable mcp.json under 0.3.0 and drop the
  now-obsolete "no portable mcp.json" note.

Claude Code is unchanged and keeps its per-account URL via userConfig.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@shayhowe
shayhowe requested a review from murreya August 7, 2026 18:27
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