MCP Services

Z Code integrates MCP (Model Context Protocol) services to extend external capabilities that Agents can call. In Settings, you can review, enable, add, and edit MCP services in one place.

• Built-in MCPs: View and enable ready-to-use services directly.
• Custom configuration: Add or edit your own MCP services as needed.

Configuration Guide

Entry Point

Click Settings in the lower-left corner of the main interface, then choose MCP Servers from the left-side navigation.

Configuration Screen

On the MCP Servers page, you can see the current MCP list and the Add MCP Server button in the upper-right corner.

Service Groups And Status

The current UI groups services by scope, such as Common, Claude CLI, Gemini, Codex, and OpenCode. Each service shows its name and command details, and can be enabled or disabled with the toggle on the right.

Add A New MCP Service

Click Add MCP Server in the upper-right corner to open the creation form. You can fill in the name, type, command, arguments, and environment variables, and switch between Form and JSON modes.

Edit An Existing MCP Service

To modify an existing service, click the edit action on the right side of the list. The edit page also supports both form and JSON configuration modes. Click Save when the changes are ready.

Key MCP Service Setups

1. Vision MCP (zai-mcp-server)

This gives the Agent the ability to understand and analyze images.

1. Follow the BigModel configuration guide and obtain your API Token.
2. In Z Code, open Settings -> MCP Servers, then edit zai-mcp-server.
3. In environment variables (env), fill in Z_AI_API_KEY and set Z_AI_MODE to ZHIPU.
4. Save and enable the service.

2. Web Search MCP (web-search-prime)

This allows the Agent to access the internet in real time and retrieve up-to-date information.

1. Follow the BigModel configuration guide and obtain your API Token.
2. In Z Code, open Settings -> MCP Servers, then edit web-search-prime.
3. Fill in your key under Authorization in the headers field using the format Bearer your_api_key.
4. Save and enable the service.

3. Web Reader MCP (web-reader)

This helps the Agent parse webpages deeply and extract structured content.

1. Follow the BigModel configuration guide and obtain your API Token.
2. In Z Code, open Settings -> MCP Servers and edit web-reader.
3. Add your key to Authorization under headers.
4. Save and enable the service.

Next Steps