personal-projects/leo-claude-mktplace
Template
0
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Page: lessons/patterns/mcp_servers-field-in-pluginjson---another-failed-debug-theory
Pages
Change V5.4.0: Multi-Model Agent Support Proposal Change V5.4.0: Multi-Model Support (Sprint 7 Implementation) Change V04.1.0: Proposal (Implementation 1) Change V04.1.0: Proposal Change-V5.2.0:-Plugin-Enhancements-(Sprint-4-Commands) Change-V5.2.0:-Plugin-Enhancements-(Sprint-5-Documentation) Change-V5.2.0:-Plugin-Enhancements-Proposal.- Change-V5.5.0:-Hook-Efficiency-Quick-Wins-(Sprint-8-Implementation) Change-V5.6.0:-Domain-Advisory-Pattern-(Sprint-9-Implementation).- Change V5.6.0: Domain Advisory Pattern Proposal Change-V5.7.0:-Data-Platform-Domain-Advisory-(Sprint-10-Implementation) RFC-Hook-Efficiency-Improvements RFC-Perf-Sentinel-Plugin Sprint-1-viz-platform-Implementation-Plan branding/header-templates branding/plugin-registry branding/progress-templates branding/visual-spec lessons/patterns/agent-model-field-not-supported-by-claude-code lessons/patterns/command-frontmatter-missing-name-field-causes-silent-load-failure lessons/patterns/hook-message-wording-affects-claude-continuation-behavior lessons/patterns/mcp-venv-symlinks-lost-on-marketplace-update---5-hour-debug-loop lessons/patterns/mcp_servers-field-in-pluginjson---another-failed-debug-theory lessons/patterns/plugin-hooks-must-be-in-separate-file-not-inline lessons/patterns/plugin-load-errors---missing-name-field-in-command-frontmatter lessons/patterns/plugin-load-failure---check-command-frontmatter-first lessons/patterns/plugin-manifest-validation---hooks-and-agents-format-requirements lessons/patterns/plugin-version-mismatch-causes-silent-load-failure lessons/patterns/reset-pandas-index-after-filtering-to-prevent-column-pollution lessons/patterns/session-2026-02-02---mcp-server-venv-package-installation-failures lessons/patterns/setup-wizard-url-format-mismatch lessons/patterns/sprint-4---new-commands-not-discoverable-until-session-restart lessons/patterns/startup-hooks-must-check-venv-cache-path-first lessons/patterns/sync-entire-plugin-directory-not-individual-files lessons/patterns/use-fixes-n-keyword-for-automatic-issue-closing-in-prs lessons/sprints/cache-clearing-breaks-mcp-tools-mid-session lessons/sprints/sprint-1---viz-platform-plugin-implementation lessons/sprints/sprint-10---domain-advisory-pattern-replication-success lessons/sprints/sprint-2---contract-validator-plugin-implementation lessons/sprints/sprint-3---agent-runaway-detection-and-timeout-handling lessons/sprints/sprint-3---background-agent-permissions-must-be-pre-granted lessons/sprints/sprint-3---mcp-server-branch-detection-bug-runs-from-installed-dir lessons/sprints/sprint-4---plugin-commands-implementation lessons/sprints/sprint-6---visual-branding-and-documentation-maintenance lessons/sprints/sprint-8---parallel-hook-optimization-success lessons/sprints/v400-release---wiki-workflow-and-versioning-patterns lessons/sprints/versioning-workflow---use-unreleased-and-release-script lessons-learned/sprints/hook-efficiency-rfc unnamed
Clone
1
lessons/patterns/mcp_servers-field-in-pluginjson---another-failed-debug-theory
Leo Miranda edited this page 2026-02-03 04:19:21 +00:00
Table of Contents

Context

Plugins failing to load with "1 error" in Claude Code /plugin output.

Failed Theory

Noticed that:

  • Working plugins (doc-guardian, git-flow, project-hygiene): NO mcp_servers field in plugin.json
  • Failing plugins (projman, pr-review, viz-platform): HAVE mcp_servers field in plugin.json

Hypothesized that the mcp_servers field was causing validation failures.

Why This Was Wrong

NOT VERIFIED YET - This was proposed as a solution without testing first. Adding to lessons learned preemptively because the pattern of proposing untested solutions has wasted hours today.

What Should Have Been Done

  1. Actually TEST removing the field from ONE plugin
  2. Restart Claude Code
  3. Check if it loads
  4. THEN report findings

Session Context

This is the 7th failed solution proposed on 2026-02-02 for the same plugin load failure issue. Previous failed attempts:

  1. Version mismatch
  2. MCP venv symlinks (5 hour loop)
  3. Agent model field
  4. Command frontmatter missing
  5. Command name field missing
  6. Frontmatter check first
  7. mcp_servers field (this one)

Key Lesson

STOP PROPOSING SOLUTIONS. TEST FIRST. REPORT RESULTS.

Tags: plugin-debugging, failed-solution, mcp_servers, wasted-time, test-first