# Chipp MCP Server Overview

Connect Claude Code or any MCP client to your Chipp apps for AI-powered app building


The Chipp MCP Server lets you connect Claude Code, Cursor, or any Model Context Protocol (MCP) client directly to your Chipp apps. This enables AI assistants 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>

## What You Can Do

Once connected, your AI assistant can:

- **List and read apps** - See all your Chipp applications and their configurations
- **Create new apps** - Build new AI apps with custom personas, models, and settings
- **Update apps** - Modify existing app configurations, system prompts, and capabilities
- **Manage knowledge sources** - Upload and organize knowledge bases for RAG
- **Manage custom actions** - Create and update API integrations
- **View analytics** - Access usage data and conversation metrics
- **Run evaluations** - Test app quality with automated evals
- **Manage tags** - Create intent detection and message tagging

## Quick Start

Add Chipp to your Claude Code configuration (`~/.claude.json`):

```json
{
  "mcpServers": {
    "chipp": {
      "url": "https://mcp.chipp.ai/mcp/messages",
      "transport": "http"
    }
  }
}
```

Then authenticate and start building:

```
"List all my Chipp apps"
"Create a new customer support bot called SupportBot"
"Update the system prompt for my FAQ app"
```

## Detailed Guides

<div className="grid gap-4 md:grid-cols-2 my-6">
  <Card title="Setup & Installation" href="/docs/guides/mcp/setup">
    Step-by-step setup for Claude Code, Cursor, and other MCP clients
  </Card>
  <Card title="OAuth Authentication" href="/docs/guides/mcp/authentication">
    Token formats, scopes, refresh flows, and security best practices
  </Card>
  <Card title="Rate Limits" href="/docs/guides/mcp/rate-limits">
    Tier-based limits, handling 429 errors, and optimization tips
  </Card>
  <Card title="Tools Reference" href="/docs/guides/mcp/tools-reference">
    Complete documentation for all 77 available tools
  </Card>
  <Card title="Common Workflows" href="/docs/guides/mcp/workflows">
    Step-by-step examples for building apps, bulk updates, and more
  </Card>
</div>

## Quick Reference

| Property | Value |
|----------|-------|
| **Server URL** | `https://mcp.chipp.ai/mcp/messages` |
| **Protocol** | JSON-RPC 2.0 over HTTP |
| **Authentication** | OAuth 2.0 with PKCE |
| **Access Token Format** | `chipp_at_xxx` (1 hour expiry) |
| **Refresh Token Format** | `chipp_rt_xxx` (30 day expiry) |

## Rate Limits

| Tier | Requests/Minute |
|------|-----------------|
| FREE | Not available |
| PRO | 30 |
| TEAM | 60 |
| BUSINESS | 120 |
| ENTERPRISE | Unlimited |

## Related

- [Building Custom MCP Servers](/docs/guides/building-custom-mcp-servers) - Create your own MCP integrations
- [MCP Pro Actions Overview](/docs/pro-actions/mcp-overview) - Connect to 20+ enterprise services
- [API Reference](/docs/api/reference) - Direct API access without MCP