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

> Install the official Aident Skill in your AI assistant, verify the setup, and keep the integration updated from 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 -y skills add aident-ai/aident-skill --skill aident-skill --agent '*' --global --yes
```

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.