Skip to content

docs: add the type field to the Claude Code MCP config example - #1725

Open
19anveshh wants to merge 1 commit into
open-circle:mainfrom
19anveshh:doc-1564
Open

19anveshh wants to merge 1 commit into
open-circle:mainfrom
19anveshh:doc-1564

Conversation

@19anveshh

@19anveshh 19anveshh commented Oct 29, 2026 •

Copy link
Copy Markdown

The Coding agents guide shows one JSON entry for the MCP server, but Claude Code reads an entry without a type as a local stdio server. Copying that entry into a project-level .mcp.json therefore does not register the server.

This adds a Claude Code example with "type": "http" next to the existing claude mcp add --transport http command, and leaves the Cursor entry as it is: Cursor documents remote servers with url and headers and does not show a type field, so one shared snippet cannot be right for both tools. That is why I did not add the field to the existing block directly.

Sources:

The same snippet also appears in the "Making Valibot easier for coding agents" blog post. I left it alone since that is a dated announcement, but I can update it too if you would rather keep both in sync.

Checked locally: prettier --check passes on the file with the repo's config, and both JSON snippets parse.

This was prepared with an AI coding assistant and reviewed line by line.

Closes #1564

Summary by CodeRabbit

  • Documentation
    • Updated the Claude Code project-level .mcp.json example to identify the Valibot MCP server as an HTTP server.
    • Clarified that Claude Code treats entries without a specified type as local stdio servers.

The coding agents guide shows one JSON entry for the MCP server, but
Claude Code reads an entry without a type as a local stdio server, so
copying that snippet into a project-level .mcp.json does not register
the server. Cursor documents url and headers without a type, so the
existing entry stays as it is and the Claude Code variant is added next
to its CLI command.

Fixes open-circle#1564.
@coderabbitai

coderabbitai Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

No actionable comments were generated in the recent review.

Recent review info
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 0ce88178-4f2d-4d85-8cce-14a52dcd7cee
Commits

Reviewing files that changed from the base of the PR and between d72f76f and b105949.

Files selected for processing: 1
  • website/src/routes/guides/(get-started)/coding-agents/index.mdx

Included review availability: This review used your included allowance. Your plan provides up to 8 included reviews per hour; 7 remain after this review.

Walkthrough

The coding agents guide adds a project-level .mcp.json example for the Valibot MCP server. The example specifies "type": "http" alongside the server URL. The guide also notes that Claude Code treats an entry without a type as a local stdio server.

Suggested reviewers: fabian-hiller

Priority: Normal

Severity of issue fixed: Low

Merge Risk: Minimal · up to b1059

The Claude Code MCP example now explicitly identifies the remote server as HTTP and is ready to merge.

Pre-merge checks: Passed 5
Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title clearly and concisely describes the main documentation change: adding the type field to the Claude Code MCP configuration example.
Linked Issues check Passed Issue #1564 asks for "type": "http" in the .mcp.json MCP server example for Claude Code. The whole-PR diff (merge base d72f76f to head b105949) adds a project-level .mcp.json example in `website…
Out of Scope Changes check Passed The whole-PR diff touches one file: the coding-agents guide. The change adds 13 lines. All added lines are a Claude Code-specific paragraph and JSON example that implement issue #1564. No unrelated fi…
Docstring Coverage Passed No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentat…
Full details: Linked Issues check

Explanation

Issue #1564 asks for "type": "http" in the .mcp.json MCP server example for Claude Code. The whole-PR diff (merge base d72f76f to head b105949) adds a project-level .mcp.json example in website/src/routes/guides/(get-started)/coding-agents/index.mdx. The new JSON block has mcpServers.valibot with "type": "http" and "url": "https://valibot.dev/mcp", which matches the issue's requested entry. The accompanying text states that Claude Code treats an entry without a type as a local stdio server, which gives the reason for the field. The existing generic Cursor and other-tools block is unchanged. The issue states the requester uses only Claude Code, so leaving that block unchanged does not leave the requirement unmet. The requirement is a docs change, and no automated test applies. The reviewed diff does not show the blog post, which the PR description says it did not change. This is not a coding requirement gap.

Full details: Out of Scope Changes check

Explanation

The whole-PR diff touches one file: the coding-agents guide. The change adds 13 lines. All added lines are a Claude Code-specific paragraph and JSON example that implement issue #1564. No unrelated files, code, or configuration changes appear in the diff. The PR description's note about the dated blog post is an explicit choice not to edit it, so no out-of-scope change exists there.

Full details: Docstring Coverage

Explanation

No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 0 functions across 0 files. (1 skipped: 1 unsupported.)

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

No issues found across 1 file

Re-trigger cubic

This branch has not been deployed

No deployments
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.

docs: add "type": "http" to .mcp.json example

1 participant