Skip to content

refactor: consolidate MCP on the makeitwork gateway - #21

Merged
xnoto merged 1 commit into
mainfrom
refactor/consolidate-mcp-gateway
Sep 11, 2026
Merged

xnoto merged 1 commit into
mainfrom
refactor/consolidate-mcp-gateway

Conversation

@xnoto

@xnoto xnoto commented Sep 11, 2026

Copy link
Copy Markdown
Owner

Mirrors xnoto/claude-config 184ea92 and 8563419, which were never applied here.

Pairs with xnoto/opencode-llama-config#1 — deploy together, since that repo's opt-outs now name gateway-qualified tools.

What changes

  • 21 servers → 12. Removes parallel-search, aws-docs, terraform-docs, apify, context7, makeitwork-argocd, makeitwork-kubernetes, makeitwork-grafana — each was a second name for a backend the gateway already re-exports.
  • makeitwork-awsmakeitwork. The URL was always https://mcp.makeitwork.cloud/mcp, the root gateway. AWS is merely one of its integrations. URL unchanged, so nothing needs re-authorizing.
  • 21 permission keys retargeted onto gateway-qualified names (aws-docs_*makeitwork_makeitwork-aws-docs_*, etc.). The grant surface was already inconsistent — makeitwork-grafana_* and apify_* had no entries at all — so this makes the remaining grants address tools that actually exist.
  • AGENTS.md rewritten. The gateway does not forward its integrations' own MCP instructions, so the context7, apify and parallel-search sections are retargeted at gateway tool names.

Two AGENTS.md claims that had drifted from the config

  • Apify was documented as "disabled globally and enabled only in projects that opt in". 74fc1f4 enabled it, and it is now unconditionally present via the gateway — so the guardrail is behavioural, and the text says so.
  • The gateway-first rule forbade "remote SaaS URLs, auth headers, or bearer-token plumbing in per-agent configs", which the makeitwork, linear and notion entries have always required. Checked against mcp-gateway/servers.json: the local gateway only serves the 7 Hatch/local ports, so the rule as written never matched reality. This consolidation drops the violation from 9 remote entries to 3.

Consequence worth reviewing

Integrations sharing one server entry can no longer be toggled with mcp.<name>.enabled. Tool denials ("makeitwork_makeitwork-apify_*": false) are now the only lever that reaches a single integration.

Verification

pre-commit run --all-files passes, including the upstream OpenCode schema check.

Empirically confirmed the inheritance model this depends on — opencode mcp list under OPENCODE_CONFIG_DIR=~/.config/opencode-llama shows the llama profile inheriting the global server set, not replacing it.

Mirrors xnoto/claude-config 184ea92 and 8563419, which were never applied here.

Route all Make IT Work Cloud and environment-neutral tooling through the
aggregating gateway instead of also configuring the same backends as standalone
servers. Removes parallel-search, aws-docs, terraform-docs, apify, context7,
makeitwork-argocd, makeitwork-kubernetes and makeitwork-grafana: each was a
second name for a backend the gateway already re-exports. 21 servers -> 12.

Renames makeitwork-aws to makeitwork. Its URL was always
https://mcp.makeitwork.cloud/mcp -- the root gateway, not an AWS-specific host.
AWS is merely one of the gateway's integrations.

Because the integrations now share one server entry, they can no longer be
toggled individually through `mcp.<name>.enabled`; a profile that must opt out
of one denies its tools instead. AGENTS.md says so, and opencode-llama-config
is updated in the same pass.

Rewrites the 21 name-coupled permission keys onto their gateway-qualified
names. The grant surface was already inconsistent -- makeitwork-grafana_* and
apify_* had no entries at all -- and the rewrite makes the remaining grants
address tools that actually exist.

The gateway does not forward its integrations' own MCP instructions, so the
context7, apify and parallel-search sections are retargeted at the gateway tool
names rather than the standalone ones. Two AGENTS.md claims that had drifted
from the config are corrected: Apify is no longer "disabled globally" (74fc1f4
enabled it, and it is now unconditionally present via the gateway, so the
guardrail is behavioural), and the gateway-first rule no longer forbids the
remote URLs and auth headers that the makeitwork, linear and notion entries have
always required.
@xnoto
xnoto merged commit 028a33b into main Sep 11, 2026
1 check passed
@xnoto
xnoto deleted the refactor/consolidate-mcp-gateway branch September 11, 2026 16:06
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