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

# Alpic MCP Server

> Manage your projects, debug deployment, and check analytics for any MCP server you host with Alpic

### Overview

The Alpic MCP Server is a hosted MCP server at `mcp.alpic.ai` that lets you interact with your Alpic account from any MCP-compatible client. You can browse teams and projects, inspect deployment logs, and review analytics.

### Available Tools

| Tool              | Description                                                         |
| ----------------- | ------------------------------------------------------------------- |
| `list-teams`      | List all teams you belong to.                                       |
| `list-projects`   | List all projects for a given team.                                 |
| `deployment-logs` | Fetch deployment logs for a specific project and environment.       |
| `get-analytics`   | Retrieve analytics data (sessions, requests, errors) for a project. |

#### Project Browser Widget

The `list-projects` tool returns a widget that displays your projects as interactive cards. Each card shows the project name, environment status, and key analytics at a glance. The widget supports both inline and fullscreen display modes so you can quickly scan your projects or dive deeper into a specific one.

<img src="https://mintcdn.com/alpic-staging/SUgEP0peVh3Vy_OH/images/mcp-server-analytics.png?fit=max&auto=format&n=SUgEP0peVh3Vy_OH&q=85&s=ba2cc9135cea22ccbc7d74a04174d20c" alt="Analytics widget" width="1286" height="690" data-path="images/mcp-server-analytics.png" />

### Connect Your MCP Client

<Tabs>
  <Tab title="Claude Code">
    <Steps>
      <Step title="Add the MCP server">
        Run the following command to add the Alpic MCP server:

        ```bash theme={null}
        claude mcp add alpic --transport http https://mcp.alpic.ai/
        ```
      </Step>

      <Step title="Authenticate">
        In your Claude Code session, run `/mcp` and select the Alpic server. This will open your browser to authenticate with your Alpic account.
      </Step>

      <Step title="Start using">
        Once authenticated, Claude Code can use the Alpic tools directly. Try asking it to list your teams.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Desktop">
    <Steps>
      <Step title="Add the MCP server">
        Add the following to your `claude_desktop_config.json`:

        ```json theme={null}
        {
          "mcpServers": {
            "alpic": {
              "command": "npx",
              "args": ["-y", "mcp-remote", "https://mcp.alpic.ai/"]
            }
          }
        }
        ```

        <Tip>
          On macOS, the config file is located at `~/Library/Application Support/Claude/claude_desktop_config.json`.
          On Windows, it is at `%APPDATA%\Claude\claude_desktop_config.json`.
        </Tip>
      </Step>

      <Step title="Authenticate">
        When opening Claude Desktop, a browser page will open to authenticate with your Alpic account.
      </Step>

      <Step title="Start using">
        Open a new conversation and ask Claude about your Alpic projects.
      </Step>
    </Steps>
  </Tab>

  <Tab title="VS Code">
    <Steps>
      <Step title="Add the MCP server">
        <a href={"vscode:mcp/install?%7B%22name%22%3A%22alpic%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.alpic.ai%2F%22%7D"}>
          <img noZoom src="https://img.shields.io/badge/VS_Code-Install_alpic-0098FF?style=flat-square&logo=visualstudiocode&logoColor=ffffff" alt="Install in VS Code" />
        </a>

        Or manually add the following to your `.vscode/mcp.json` at the root of your workspace:

        ```json theme={null}
        {
          "servers": {
            "alpic": {
              "url": "https://mcp.alpic.ai/",
              "type": "http"
            }
          }
        }
        ```

        <Tip>
          You can also configure MCP servers globally instead of per-workspace.
          On macOS, the global config is at `~/Library/Application Support/Code/User/mcp.json`.
          On Windows, it is at `%APPDATA%\Code\User\mcp.json`.
        </Tip>
      </Step>

      <Step title="Authenticate">
        When opening VS Code, a browser page will open to authenticate with your Alpic account.
      </Step>

      <Step title="Start using">
        Open a new conversation and ask Copilot about your Alpic projects.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Cursor">
    <Steps>
      <Step title="Add the MCP server">
        <a href={"cursor://anysphere.cursor-deeplink/mcp/install?name=alpic&config=eyJ1cmwiOiJodHRwczovL21jcC5hbHBpYy5haS8iLCJ0eXBlIjoiaHR0cCJ9"}>
          <img noZoom src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor" />
        </a>

        Or manually add the following to your `~/.cursor/mcp.json`:

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

      <Step title="Connect the server">
        Go to **Cursor Settings → Tools and MCP** and hit **Connect** on the Alpic server. This will open your browser to authenticate with your Alpic account.
      </Step>

      <Step title="Start using">
        Open a new chat and ask Cursor about your Alpic projects.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Clients supporting MCP Apps

Our MCP Server is using the MCP Apps extension that allows rendering of rich UI interfaces through custom Views. When used with MCP Apps compatible clients, it provides interactive visual components alongside the standard tool responses.

<Tabs>
  <Tab title="ChatGPT">
    <Steps>
      <Step title="Open ChatGPT settings">
        In ChatGPT, go to **Settings → Apps**.
      </Step>

      <Step title="Create a new app">
        Click **Create** and paste the following URL:

        ```
        https://mcp.alpic.ai/
        ```
      </Step>

      <Step title="Connect to Alpic">
        Select the OAuth authentication flow and leave the optional fields empty.

        Hit create and you will be prompted to connect using your Alpic account.
      </Step>

      <Step title="Start chatting">
        Open a new conversation and ask ChatGPT about your Alpic projects. It will use the connected tools automatically.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude">
    <Steps>
      <Step title="Open Claude settings">
        On [claude.ai](https://claude.ai), go to **Settings → Connectors**.
      </Step>

      <Step title="Add the Alpic connector">
        Click **Add connector** and paste the following URL:

        ```
        https://mcp.alpic.ai/mcp
        ```
      </Step>

      <Step title="Connect to Alpic">
        Hit create and you will be prompted to connect using your Alpic account.
      </Step>

      <Step title="Start chatting">
        Open a new conversation and ask Claude about your Alpic projects. It will use the connected tools automatically.
      </Step>
    </Steps>
  </Tab>
</Tabs>