> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aident.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Aident Skill

> Add Aident to your AI assistant in one command

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](https://skills.sh), install with a single command:

```bash theme={null}
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:

```text theme={null}
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.

<AccordionGroup>
  <Accordion title="Claude Code">
    Run in your terminal:

    ```bash theme={null}
    claude mcp add --transport http aident https://loadout.aident.ai/mcp
    ```

    Or add to `~/.claude.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "aident": {
          "type": "http",
          "url": "https://loadout.aident.ai/mcp"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Claude Desktop">
    Add to your config file:

    * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
    * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

    ```json theme={null}
    {
      "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`.
  </Accordion>

  <Accordion title="Cursor IDE">
    Add to `.cursor/mcp.json` in your project root:

    ```json theme={null}
    {
      "mcpServers": {
        "aident": {
          "url": "https://loadout.aident.ai/mcp"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="VS Code (Copilot)">
    Add to `.vscode/mcp.json` in your project root:

    ```json theme={null}
    {
      "servers": {
        "aident": {
          "type": "http",
          "url": "https://loadout.aident.ai/mcp"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Windsurf">
    Add to `~/.codeium/windsurf/mcp_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "aident": {
          "serverUrl": "https://loadout.aident.ai/mcp"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Codex">
    Run in your terminal:

    ```bash theme={null}
    codex mcp add aident --url https://loadout.aident.ai/mcp
    ```

    Or add to `~/.codex/config.toml` (or `.codex/config.toml` for a trusted project):

    ```toml theme={null}
    [mcp_servers.aident]
    url = "https://loadout.aident.ai/mcp"
    ```

    Verify the server is configured:

    ```bash theme={null}
    codex mcp list
    ```
  </Accordion>

  <Accordion title="Gemini CLI">
    Add to `~/.gemini/settings.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "aident": {
          "httpUrl": "https://loadout.aident.ai/mcp"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Other Clients">
    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.
  </Accordion>
</AccordionGroup>

## 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.

<Tip>
  Try asking: "Use Aident Loadout to check my integration status"
</Tip>

## Next Steps

* [MCP Server Setup](/documentation/mcp-server-setup) — Detailed setup guide with troubleshooting
* [MCP API Reference](/documentation/mcp-api-reference) — Full reference for the Aident tool suite