aix Get started

aix mcp install

aix mcp install

Install an MCP server from a repository, local file, or git URL

Synopsis

Install an MCP server configuration from a configured repository, local JSON file, or git URL.

The source can be:

  • An MCP server name to search in configured repositories
  • A local path to a .json MCP configuration file
  • A git URL (https://, git@, or .git suffix) containing mcp/*.json files

When given a name (not a path), aix searches configured repositories first. If the server exists in multiple repositories, you will be prompted to select one. Use –file to skip repo search and treat the argument as a file path.

For git URLs, the repository is cloned to a temporary directory, MCP servers are discovered in the mcp/ directory, and you select which to install.

aix mcp install <source> [flags]

Examples

  # Install by name from configured repos
  aix mcp install github-mcp

  # Install from local JSON file
  aix mcp install ./servers/github.json
  aix mcp install --file github.json  # Force file path interpretation

  # Install from absolute path
  aix mcp install /path/to/server.json

  # Install from git repository
  aix mcp install https://github.com/user/mcp-servers.git

  # Force overwrite existing server
  aix mcp install github-mcp --force

Options

  -f, --file    treat argument as a file path instead of searching repos
      --force   overwrite existing MCP server without confirmation
  -h, --help    help for install

Options inherited from parent commands

      --log-file string     write logs to file in JSON format
      --log-format string   log format: text, json (default "text")
  -p, --platform strings    target platform(s): claude, opencode (default: all detected)
  -q, --quiet               suppress non-error output
  -v, --verbose count       increase verbosity level (e.g., -v, -vv)

SEE ALSO

  • aix mcp - Manage MCP server configurations
Auto generated by spf13/cobra on 24-Jan-2026
Edit this page on GitHub
Prev
aix mcp enable
Next
aix mcp list