Skip to content

Align mcp-server-dev skills with claude.com/docs connector guidance#1418

Open
tobinsouth wants to merge 1 commit intomainfrom
tobin/mcp-server-dev-docs-links
Open

Align mcp-server-dev skills with claude.com/docs connector guidance#1418
tobinsouth wants to merge 1 commit intomainfrom
tobin/mcp-server-dev-docs-links

Conversation

@tobinsouth
Copy link
Copy Markdown
Collaborator

Summary

The plugin's three skills currently reference only the generic MCP spec. This PR adds Claude-specific guidance and links to the new pages at https://claude.com/docs/connectors/building so the skill produces servers that pass directory review on the first try.

Changes

  • build-mcp-server/SKILL.md — instruct Claude to load https://claude.com/docs/llms-full.txt before scaffolding; add Phase 6: Test in Claude and publish (custom-connector test path, review checklist, submission, "also ship a plugin")
  • references/auth.md — add Claude auth-type table (oauth_dcr, oauth_cimd, oauth_anthropic_creds, custom_connection, none), callback URL, and not-supported list (no static_bearer, no pure m2m client_credentials)
  • references/tool-design.md — add Anthropic Directory hard requirements: readOnlyHint/destructiveHint/title required, ≤64-char names, read/write split, no behavioral directives in descriptions, freeform-API tools must reference target docs
  • build-mcp-app/SKILL.md — add Claude host specifics (prefersBorder, safeAreaInsets, _meta.ui.csp), submission screenshot specs, and custom-connector testing path
  • build-mcpb/SKILL.md — note MCPB is secondary; remote is recommended for directory listing

Doc links added

All point at claude.com/docs/connectors/building/{authentication, testing, review-criteria, submission, what-to-build} plus llms-full.txt.

Test plan

  • Run /mcp-server-dev:build-mcp-server and confirm it fetches llms-full.txt and surfaces Phase 6
  • Verify all added URLs resolve (depends on claude-ai-docs PR Add Autofix Bot plugin #23 merging)

- build-mcp-server: load llms-full.txt for Claude-specific context;
  add Phase 6 (test in Claude, review checklist, submit, ship plugin)
- references/auth.md: add Claude auth-type table, callback URL,
  not-supported list
- references/tool-design.md: add Anthropic Directory hard requirements
  (annotations, name length, read/write split, prompt-injection rule)
- build-mcp-app: add Claude host specifics (prefersBorder,
  safeAreaInsets, CSP) and submission asset specs; testing via
  custom connector
- build-mcpb: note remote servers are the recommended directory path
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