# MCP Server

> Run Copyleaks scans, read results, and manage scan profiles from any MCP-capable AI client.

There is nothing to install and no API key to paste.

**Requires a Copyleaks account that can run a scan in the app on a paid balance** - subscription, prepaid, or an organization-paid account. Free and lapsed accounts cannot connect, and a Copyleaks API key on its own is not a way in.

## What you need, and what works where
**You need an AI client with a place to add an MCP connector.** Claude (claude.ai, Claude Desktop, Claude Code), Codex, Gemini CLI, Antigravity, Cursor and VS Code all have one. A product without that setting can't connect, on any plan.

**All twelve tools work in every one of them, chat included.** The one difference is the upload step: a larger file or an image is sent to an upload address, which needs a client that can run a command on your machine.

| Capability | claude.ai · Claude Desktop **Chat** tab | Claude Desktop **Cowork** tab | Claude Desktop **Code** tab · Claude Code · Codex · Gemini CLI · Antigravity · Cursor · VS Code |
|---|---|---|---|
| All twelve tools - scan, results, history, profiles, balance | ✅ | ✅ | ✅ |
| Pasted text · web pages · small files | ✅ | ✅ | ✅ |
| Larger files | ⛔ | ⛔ | ✅ |
| Image scans | ⛔ | ⛔ | ✅ |
| Reads a folder you share | ⛔ | ✅ | ✅ |

Where a cell says no, upload the file or image in the Copyleaks app, then ask your agent to read the finished scan.

### Which Claude am I using?

Claude Desktop has three tabs - Chat, Cowork and Code - and the tab decides the column above.

| Where you are | What it is | How Copyleaks is added |
|---|---|---|
| **claude.ai** in a browser | Chat | **Customize → Connectors** |
| **Claude Desktop → Chat tab** | The same chat, as an app | The same connector - it follows your Claude account |
| **Claude Desktop → Cowork tab** | Works inside a folder you hand it; can run tasks on a schedule | The same connector as Chat |
| **Claude Desktop → Code tab** | **Claude Code** | `claude mcp add`, or `.mcp.json` - the same config as the terminal |
| **Claude Code** in a terminal, an IDE, or on the web | Claude Code | The same |

**Two tells.** The Code tab shows a terminal and file diffs; the Cowork tab shows a task plan and a folder you chose; Chat shows a conversation and nothing else.


## The endpoint

| | |
|---|---|
| **Server name** | `copyleaks_app` |
| **Endpoint** | `https://extensions.copyleaks.com/mcp` |
| **Transport** | Streamable HTTP (MCP 2025-06-18). Not SSE, not stdio |
| **Authorization** | OAuth 2.1 with PKCE (S256), advertised per RFC 9728 |

The endpoint names its own authorization server, so there is nothing to configure by hand.