Skip to main content
Install the single Aident skill to teach your AI assistant how to use Aident Loadout integrations.

​
One-Command Install

If your agent supports Skills.sh, install with a single command: 
npx skills add aident-ai/aident-skill
This installs local agent guidance only. It does not automatically configure MCP. For first-time setup, ask your agent: 
Follow https://aident.ai/SETUP.md

​
Manual Setup

If you want MCP instead of the CLI, add the Aident Loadout server URL to your client’s MCP configuration file.
Run in your terminal:
claude mcp add --transport http aident https://loadout.aident.ai/mcp
Or add to ~/.claude.json:
{
  "mcpServers": {
    "aident": {
      "type": "http",
      "url": "https://loadout.aident.ai/mcp"
    }
  }
}
Add to your config file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "aident": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://loadout.aident.ai/mcp"]
    }
  }
}
Or on Pro/Max/Team/Enterprise plans: Settings → Connectors → Add and enter https://loadout.aident.ai/mcp.
Add to .cursor/mcp.json in your project root:
{
  "mcpServers": {
    "aident": {
      "url": "https://loadout.aident.ai/mcp"
    }
  }
}
Add to .vscode/mcp.json in your project root:
{
  "servers": {
    "aident": {
      "type": "http",
      "url": "https://loadout.aident.ai/mcp"
    }
  }
}
Add to ~/.codeium/windsurf/mcp_config.json:
{
  "mcpServers": {
    "aident": {
      "serverUrl": "https://loadout.aident.ai/mcp"
    }
  }
}
Run in your terminal:
codex mcp add aident --url https://loadout.aident.ai/mcp
Or add to ~/.codex/config.toml (or .codex/config.toml for a trusted project):
[mcp_servers.aident]
url = "https://loadout.aident.ai/mcp"
Verify the server is configured:
codex mcp list
Add to ~/.gemini/settings.json:
{
  "mcpServers": {
    "aident": {
      "httpUrl": "https://loadout.aident.ai/mcp"
    }
  }
}
Any MCP-compatible client (Goose, Kiro, OpenCode, Antigravity, Factory, etc.) can connect using the server URL https://loadout.aident.ai/mcp. Refer to your client’s documentation for where to add MCP server configurations.

​
Authenticate

On first use, your MCP client will automatically:
  1. Discover Aident’s OAuth endpoints
  2. Open your browser for login (Google OAuth or magic link)
  3. Store your access token locally
No manual token management needed — the client handles everything.

​
Verify

Ask your AI assistant to use Aident Loadout. Requests should route to external integrations, Vault status, execution, and audit history.
Try asking: “Use Aident Loadout to check my integration status”

​
Next Steps