mirror of https://github.com/agent0ai/agent-zero.git synced 2026-05-19 07:59:34 +00:00

Alessandro 58b161e5d3 docs: make Agent Zero guides more human

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.

2026-05-09 00:02:11 +02:00

2.1 KiB

Raw Blame History

Advanced MCP Configuration

Most users should start with MCP Setup.

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.

Basic Shape

Command-based MCP tool:

{
  "mcpServers": {
    "sqlite": {
      "command": "uvx",
      "args": ["mcp-server-sqlite", "--db-path", "/root/db.sqlite"]
    }
  }
}

URL-based MCP tool:

{
  "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.

2.1 KiB Raw Blame History