> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://you.com/docs/llms.txt.
> For full documentation content, see https://you.com/docs/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://you.com/docs/_mcp/server.

# Claude Code

Give Claude Code real-time web search, content extraction, and citation-backed research through the [You.com MCP Server](/docs/build-with-agents/mcp-server).

## Quick setup

## Add You.com to Claude Code (no API key)

```bash
claude mcp add --transport http you-com https://api.you.com/mcp
```

Claude Code initiates the OAuth 2.1 flow automatically — sign in with your You.com account in the browser window that opens, and you're done. No API key, no copy-pasting tokens.

## Verify the tools are loaded

Inside a Claude Code session:

```bash
/mcp
```

You should see `you-com` listed with `you-search`, `you-contents`, and `you-research`.

## Try it

```text
Search for the three latest TypeScript 5.5 features and show me code examples for each.
```

## Skip OAuth (use an API key)

If you'd rather pass an API key directly — useful for CI, scripts, or shared dev containers:

```bash
claude mcp add --transport http you-com https://api.you.com/mcp \
  --header "Authorization: Bearer YDC-YOUR-API-KEY"
```

Get a key at [you.com/platform](https://you.com/platform).

## Free tier (no account, no OAuth)

Want to try it before signing in?

```bash
claude mcp add --transport http you-com https://api.you.com/mcp?profile=free
```

Free tier gives `you-search` only, 100 queries per day. No signup, no auth.

## Quick demo

```text
Research the trade-offs between WebAssembly and JavaScript for performance-critical browser apps. Use citations.
```

```text
Extract the content from https://modelcontextprotocol.io/specification and summarize the authentication section.
```

## Troubleshooting

* **OAuth window doesn't open** — confirm Claude Code is on the latest version. Run `claude --version` and update if needed.
* **"Invalid token" after sign-in** — restart Claude Code to clear cached token state, then retry.
* **401 with API key** — check for extra spaces or smart quotes in the `--header` value.
* **Tools don't show up in `/mcp`** — list configured servers with `claude mcp list`; if `you-com` is there but tools are missing, restart Claude Code.