# Chipp MCP Server

Connect any MCP client to manage your Chipp apps programmatically


The Chipp MCP Server enables AI assistants like Claude Code, Cursor, and other Model Context Protocol (MCP) clients to read, create, and manage your Chipp applications programmatically.

<Callout type="info">
  MCP server access requires a Pro plan or higher. <a href="https://app.chipp.ai/plans" target="_blank" rel="noopener noreferrer" className="text-blue-600 hover:text-blue-800 underline">Upgrade to Pro</a>
</Callout>

## Why Use the MCP Server?

| Use Case | Without MCP | With MCP |
|----------|-------------|----------|
| Create 10 apps | Click through UI 10 times | One conversation with your AI |
| Update prompts across apps | Open each app, edit, save | "Update all my apps to use GPT-4o" |
| Bulk add knowledge sources | Upload files one by one | "Add these 50 URLs to my FAQ bot" |
| Monitor analytics | Check dashboard daily | "Show me apps with low satisfaction" |
| Run evaluations | Manual testing | "Run evals on all my customer service bots" |

## Comparison: MCP vs API vs Pro Actions

| Feature | MCP Server | REST API | Pro Actions |
|---------|------------|----------|-------------|
| **Best for** | AI-assisted workflows | Custom integrations | Connecting external services |
| **Authentication** | OAuth 2.0 + PKCE | API Keys | OAuth per service |
| **Rate limits** | Tier-based | Tier-based | Per service limits |
| **Scope** | Full Chipp platform | Full Chipp platform | External services only |
| **Typical user** | Developers using AI tools | Backend developers | No-code builders |

## What You Can Do

Once connected, your AI assistant can manage:

<div className="grid gap-4 md:grid-cols-2 my-6">
  <Card title="Apps" href="/docs/guides/mcp/tools-reference#apps">
    List, create, update, and delete applications
  </Card>
  <Card title="Knowledge Sources" href="/docs/guides/mcp/tools-reference#knowledge-sources">
    Add URLs, upload documents, refresh RAG indexes
  </Card>
  <Card title="Analytics" href="/docs/guides/mcp/tools-reference#analytics">
    Search conversations, view metrics, export data
  </Card>
  <Card title="Tags & Evals" href="/docs/guides/mcp/tools-reference#tags">
    Create intent tags, run quality evaluations
  </Card>
  <Card title="Deployments" href="/docs/guides/mcp/tools-reference#deployments">
    Manage Slack, WhatsApp, Email, and Voice channels
  </Card>
  <Card title="Prompt Engineering" href="/docs/guides/mcp/tools-reference#prompt-engineering">
    AI-powered prompt improvement and model selection
  </Card>
</div>

## Quick Start

### 1. Add to Your MCP Client

Add the Chipp server to your configuration:

**Claude Code** (`~/.claude.json`):
```json
{
  "mcpServers": {
    "chipp": {
      "url": "https://mcp.chipp.ai/mcp/messages",
      "transport": "http"
    }
  }
}
```

**Cursor** (Settings > MCP):
```json
{
  "chipp": {
    "url": "https://mcp.chipp.ai/mcp/messages",
    "transport": "http"
  }
}
```

### 2. Authenticate

When you first use a Chipp tool, your client will open a browser window. Log in with your Chipp account to authorize access.

### 3. Start Building

```
"List all my Chipp apps"
"Create a customer support bot called HelpDesk"
"Add https://docs.example.com to my FAQ app's knowledge base"
"Show me conversation analytics for the past week"
```

## Server Details

| Property | Value |
|----------|-------|
| **Server URL** | `https://mcp.chipp.ai/mcp/messages` |
| **Discovery** | `https://app.chipp.ai/.well-known/oauth-authorization-server` |
| **Protocol** | JSON-RPC 2.0 over HTTP |
| **Authentication** | OAuth 2.0 with PKCE |

## Guides

<div className="grid gap-4 md:grid-cols-2 my-6">
  <Card title="Setup & Installation" href="/docs/guides/mcp/setup">
    Detailed setup for Claude Code, Cursor, and custom clients
  </Card>
  <Card title="OAuth Authentication" href="/docs/guides/mcp/authentication">
    Token flow, scopes, refresh tokens, and security
  </Card>
  <Card title="Rate Limits" href="/docs/guides/mcp/rate-limits">
    Tier limits, handling 429 errors, best practices
  </Card>
  <Card title="Tools Reference" href="/docs/guides/mcp/tools-reference">
    Complete reference for all 77 available tools
  </Card>
  <Card title="Common Workflows" href="/docs/guides/mcp/workflows">
    Step-by-step examples for common tasks
  </Card>
</div>

## Need Help?

- [Troubleshooting Guide](/docs/guides/mcp/authentication#troubleshooting)
- [Email support@chipp.ai](mailto:support@chipp.ai)
- [Join Discord](https://discord.gg/chipp) for community help