Skip to content

Conversation

@olaservo
Copy link
Member

Summary

Add MCP docs server configuration to the Claude Code GitHub Action, enabling Claude to look up the latest MCP protocol documentation and schema references when working on MCP-related code or reviewing changes.

Type of Change

  • Bug fix (non-breaking change that fixes an issue)
  • New feature (non-breaking change that adds functionality)
  • Documentation update
  • Refactoring (no functional changes)
  • Test updates
  • Build/CI improvements

Changes Made

  1. Added .mcp.json - New MCP server configuration file at project root with the mcp-docs HTTP server:

    {
      "mcpServers": {
        "mcp-docs": {
          "type": "http",
          "url": "https://modelcontextprotocol.io/mcp"
        }
      }
    }
  2. Updated .github/workflows/claude.yml:

Related Issues

N/A

Testing

Have not tested this yet.

  • Tested in UI mode
  • Tested in CLI mode
  • Tested with STDIO transport
  • Tested with SSE transport
  • Tested with Streamable HTTP transport
  • Added/updated automated tests
  • Manual testing performed

Test Results and/or Instructions

This is a CI configuration change. To verify:

  1. Trigger the Claude Code action on a PR or issue mentioning @claude with an MCP-related question
  2. Verify Claude uses the mcp-docs MCP server to look up documentation

Checklist

  • Code follows the style guidelines (ran npm run prettier-fix)
  • Self-review completed
  • Code is commented where necessary
  • Documentation updated (README, comments, etc.)

Breaking Changes

None

Additional Context

The .mcp.json file also benefits local Claude Code CLI users who clone the repository, as it will automatically configure the mcp-docs server for them.

@olaservo olaservo marked this pull request as draft November 27, 2025 14:52
@olaservo
Copy link
Member Author

Converting to draft until I fix a couple issues with allowed tools config

@richardkmichael
Copy link
Collaborator

👍 I've been doing this for awhile and it works well.

I had noticed the use of --system-prompt vs. --append-system-prompt, and wondered if that had been getting better "review" results by removing Claude's focus on software engineering.

olaservo and others added 2 commits January 18, 2026 20:02
- Add .mcp.json with mcp-docs HTTP server configuration
- Update claude.yml to use --mcp-config and --append-system-prompt
- Add instructions for Claude to use MCP docs and schema references

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Add mcp__mcp-docs to allowedTools so Claude can actually use the
MCP documentation server when reviewing MCP-related code.

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@olaservo olaservo force-pushed the add-mcp-docs-server-to-claude branch from 98e2710 to 4835b73 Compare January 19, 2026 03:26
@olaservo olaservo marked this pull request as ready for review January 19, 2026 03:26
@olaservo
Copy link
Member Author

Hi @cliffhall , I finally took this out of draft - this should help as a reference for when we tag claude in the repo.

Copy link
Member

@cliffhall cliffhall left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! 👍

@cliffhall cliffhall merged commit 6dc5d1a into modelcontextprotocol:main Jan 20, 2026
5 checks passed
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.

3 participants