Skip to content

Commit 51b6390

Browse files
committed
docs: clarify mcpServers version requirement
1 parent 0a3c7a5 commit 51b6390

2 files changed

Lines changed: 6 additions & 0 deletions

File tree

web/content/docs/11-configuration-file.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -192,6 +192,8 @@ Both formats are accepted. The array format is automatically normalized to the o
192192

193193
Defines MCP servers that agents can connect to. Each key is the server name. This page covers the `mcpServers` field structure. For setup flow, generated files, and conflict behavior during install, see [Agent Setup — MCP Servers](/docs/agent-setup#mcp-servers).
194194

195+
> **Note:** The `mcpServers` field is supported in AI DevKit `0.23.0` or later.
196+
195197
MCP settings can be stored either by initializing from a template or by editing `.ai-devkit.json` directly. `ai-devkit install` reads the final MCP settings from `.ai-devkit.json` and generates MCP config files only for environments that currently support MCP output.
196198

197199
Every server definition requires a `transport` field set to `stdio`, `http`, or `sse`. The remaining fields depend on the transport type:

web/content/docs/9-agent-setup.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,8 @@ ai-devkit init --docs-dir ./ai-docs
133133

134134
Templates can include MCP server definitions. Add a `mcpServers` section to your template:
135135

136+
> **Note:** `mcpServers` support requires AI DevKit `0.23.0` or later.
137+
136138
```yaml
137139
mcpServers:
138140
memory:
@@ -175,6 +177,8 @@ When using a template with a `skills` section, skills from the template are inst
175177

176178
[MCP (Model Context Protocol)](https://modelcontextprotocol.io/) servers give AI agents extended capabilities such as persistent memory, database access, or external tool integrations. Define MCP servers in `.ai-devkit.json` and AI DevKit generates the environment-specific config files for you.
177179

180+
> **Note:** `mcpServers` generation and install flow require AI DevKit `0.23.0` or later.
181+
178182
MCP configuration is currently generated for **Claude Code** (`.mcp.json`) and **Codex** (`.codex/config.toml`).
179183

180184
If your project uses only environments that do not currently support MCP generation, AI DevKit still saves the `mcpServers` definitions in `.ai-devkit.json`, but no environment-specific MCP config files are created.

0 commit comments

Comments
 (0)