MCP Servers

The Model Context Protocol (MCP) allows you to connect your AI assistant to external data and tools. aix provides a unified interface to manage these servers across all your configured platforms.

Overview#

With aix, you can:

• Add servers once and deploy them to all supported platforms.
• Manage environment variables securely.
• Enable/Disable servers on the fly without editing config files manually.

Adding Servers#

To add an MCP server, use the mcp add command. You can install servers from NPM, Python packages, or local scripts.

Syntax#

aix mcp add <name> <command> [args...] [flags]

Examples#

Add the GitHub MCP Server (NPM):

aix mcp add github npx -y @modelcontextprotocol/server-github \
  --env GITHUB_TOKEN=ghp_your_token_here

Add a Local Python Server:

aix mcp add my-tool python /path/to/server.py

Add with Multiple Environment Variables:

aix mcp add postgres npx -y @modelcontextprotocol/server-postgres \
  --env POSTGRES_URL=postgresql://localhost/db \
  --env POSTGRES_USER=admin

Listing Servers#

View all configured servers and their status across platforms.

aix mcp list

Output:

NAME      COMMAND                     STATUS    PLATFORMS
github    npx @model.../server-github Enabled   [claude, opencode]
postgres  npx @model.../server-postgres Disabled  [claude]

Managing Servers#

Enabling & Disabling#

You can temporarily disable a server without removing it.

# Disable a server
aix mcp disable github

# Enable a server
aix mcp enable github

Removing Servers#

To permanently remove a server configuration:

aix mcp remove github

Configuration Details#

aix automatically translates your MCP configuration into the native format for each platform:

• Claude Code: Updates ~/.claude/config.json (or project-specific configs).
• OpenCode: Updates mcpServers in opencode.json.
• Gemini CLI: Updates ~/.gemini/settings.toml.

Environment Variables#

Environment variables provided via --env are stored securely in the platform’s configuration. aix ensures that sensitive tokens are passed correctly to the underlying MCP server process.

Troubleshooting#

If a server fails to start, use mcp show to inspect its details and logs (if available).

aix mcp show github