mirror of
https://github.com/agent0ai/agent-zero.git
synced 2026-05-26 07:25:55 +00:00
58b161e5d3
Refresh README, quickstart, and the docs index around Browser, Desktop, A0 CLI, projects, memory, skills, profiles, and model presets. Add optimized scoped screenshots for Web UI, Browser, Desktop, and CLI workflows. Trim architecture-heavy developer pages toward DeepWiki handoffs so local docs stay focused on practical user guidance.
80 lines
2.1 KiB
Markdown
80 lines
2.1 KiB
Markdown
# Advanced MCP Configuration
|
|
|
|
Most users should start with [MCP Setup](../guides/mcp-setup.md).
|
|
|
|
This page is for people who need to paste or review MCP JSON by hand. MCP
|
|
architecture and source-linked internals live in
|
|
[DeepWiki for Agent Zero](https://deepwiki.com/agent0ai/agent-zero).
|
|
|
|
## Basic Shape
|
|
|
|
Command-based MCP tool:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"sqlite": {
|
|
"command": "uvx",
|
|
"args": ["mcp-server-sqlite", "--db-path", "/root/db.sqlite"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
URL-based MCP tool:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"external-api": {
|
|
"url": "https://api.example.com/mcp",
|
|
"headers": {
|
|
"Authorization": "Bearer YOUR_API_KEY"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Common Fields
|
|
|
|
| Field | Meaning |
|
|
| --- | --- |
|
|
| `command` | Starts a local MCP tool from a command. |
|
|
| `args` | Arguments passed to that command. |
|
|
| `url` | Connects to an MCP tool that is already running. |
|
|
| `headers` | Optional HTTP headers, often used for authentication. |
|
|
| `env` | Optional environment variables for command-based tools. |
|
|
| `disabled` | Temporarily turns one MCP entry off. |
|
|
|
|
Use `command` for local tools and `url` for tools that are already running
|
|
somewhere else.
|
|
|
|
## Docker Addresses
|
|
|
|
If Agent Zero runs in Docker, remember that "localhost" means the container, not
|
|
always your host machine.
|
|
|
|
| Where the MCP tool runs | Address to use from Agent Zero |
|
|
| --- | --- |
|
|
| Host machine on macOS or Windows | `host.docker.internal` |
|
|
| Another container | The container name on the same Docker network |
|
|
| Remote machine | Its reachable HTTPS URL |
|
|
| Inside Agent Zero's container | A command-based config |
|
|
|
|
On Linux, `host.docker.internal` may need extra Docker setup. Running the MCP
|
|
tool in the same Docker network is often simpler.
|
|
|
|
## Safety
|
|
|
|
- Use MCP tools you trust.
|
|
- Keep real API keys out of public screenshots and repositories.
|
|
- Prefer project secrets or environment variables for credentials.
|
|
- Remove MCP tools you no longer use.
|
|
|
|
## Related
|
|
|
|
- [MCP Setup](../guides/mcp-setup.md)
|
|
- [Browser Guide](../guides/browser.md)
|
|
- [A0 CLI Connector](../guides/a0-cli-connector.md)
|
|
- [DeepWiki for Agent Zero](https://deepwiki.com/agent0ai/agent-zero)
|