> ## 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 Aident MCP skill to access Aident Loadout integrations and Playbook workflows directly from your AI assistant.

## One-Command Install

If your MCP client supports [Skills.sh](https://skills.sh), install with a single command:

```bash theme={null}
npx skills add aident-ai/aident-skill
```

This automatically configures the Aident MCP server for your client.

## Manual Setup

Add the Loadout server URL to your client's MCP configuration file. For Playbook workflows, use `https://app.aident.ai/playbook/mcp` as a separate MCP server URL.

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

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

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

    ```json theme={null}
    {
      "mcpServers": {
        "aident": {
          "type": "http",
          "url": "https://app.aident.ai/loadout/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://app.aident.ai/loadout/mcp"]
        }
      }
    }
    ```

    Or on **Pro/Max/Team/Enterprise** plans: **Settings → Connectors → Add** and enter `https://app.aident.ai/loadout/mcp`.
  </Accordion>

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

    ```json theme={null}
    {
      "mcpServers": {
        "aident": {
          "url": "https://app.aident.ai/loadout/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://app.aident.ai/loadout/mcp"
        }
      }
    }
    ```
  </Accordion>

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

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

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

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

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

    ```toml theme={null}
    [mcp_servers.aident]
    url = "https://app.aident.ai/loadout/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://app.aident.ai/loadout/mcp"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Other Clients">
    Any MCP-compatible client (Goose, Kiro, OpenCode, Antigravity, Factory, etc.) can connect using the server URL `https://app.aident.ai/loadout/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 an Aident tool. You should see Aident tools available across auth, skills, integrations, playbooks, templates, and dashboard.

<Tip>
  Try asking: "Use Aident to list my available skills" or "Check my Aident 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