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

[hyunbinseo]

Claude seems to require "type": "http" for JSON based MCP configuration work.

Confirmed in Claude Code v2.1.218

"valibot": {
+ "type": "http",
  "url": "https://valibot.dev/mcp"
}

I only use Claude Code for now, so I am not certain about other agents.

Reference

• Claude Docs https://code.claude.com/docs/en/mcp#local-scope
• Working Example hyunbinseo/svelte-kit-template@1f85c45

[fabian-hiller]

@dosu can you verify this?

[dosubot]

This looks correct. The current .mcp.json example in the coding agents guide only includes the url field without a type:

"valibot": {
  "url": "https://valibot.dev/mcp"
}

There's already an inconsistency in the docs — the CLI command explicitly specifies --transport http [1], but the JSON example omits the corresponding "type": "http" field.

The working example from @hyunbinseo confirms that Claude Code's .mcp.json uses "type": "http" for HTTP-based MCP servers (alongside "type": "stdio" for local command-based ones).

I wasn't able to access the Claude Code docs directly to confirm whether "type": "http" is strictly required or just recommended, but adding it makes the JSON config consistent with the CLI setup and aligns with how other MCP servers are configured in practice. It's a reasonable and safe change to make.

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.

[hyunbinseo]

Quick search but Codex seems to be use config.toml instead of .mcp.json:

We've recently improved the configuration mechanism for MCP servers inside of Codex. There's now a GUI-based settings panel. We've also recently added the ability to configure MCP servers on a per-project basis using project-local .codex/config.toml files.

openai/codex#2901 (comment)

[mcp_servers.openaiDeveloperDocs]
url = "https://developers.openai.com/mcp"

https://developers.openai.com/learn/docs-mcp