Yavy Logo
Yavy
Back to Integrations
Setup time: ~2 minutes

Connect Yavy to Claude Desktop

Give Claude Desktop access to your documentation with Yavy's MCP server, or export Skills packages for offline use. Stop hallucinations and get accurate, sourced answers from your actual content.

Why Connect Claude to Yavy?

Claude is incredibly powerful, but it can only work with information from its training data. By connecting Yavy, you give Claude access to your specific documentation - framework guides, API references, internal wikis, and more. No more guessing or making things up.

  • Search your documentation directly from Claude conversations
  • Get accurate, grounded answers instead of hallucinations
  • Automatic source attribution with clickable links
  • Real-time sync keeps content up to date
  • Works with Claude's powerful reasoning capabilities

Example Query

You ask Claude:

"How do I implement authentication in Next.js 14?"

Claude searches your docs and responds:

"Based on the Next.js documentation you've indexed, here's how to implement authentication... [Source: nextjs.org/docs/authentication]"

Setup Instructions

1

Create a Yavy Project

First, you need a Yavy project with indexed content. If you haven't already:

  1. Sign up for a free Yavy account
  2. Create a new project and add your documentation source (URL, GitHub repo, Notion, or Confluence)
  3. Wait for indexing to complete (usually 1-2 minutes)
  4. Copy your MCP server URL from the project dashboard
2

Install Claude Desktop

Make sure you have Claude Desktop installed on your computer. You can download it from Anthropic's official website.

Download Claude Desktop
3

Configure MCP Server

Open Claude Desktop, go to Settings > Developer > Edit Config to open the configuration file, then paste:

claude_desktop_config.json
{
  "mcpServers": {
    "yavy": {
      "type": "http",
      "url": "https://yavy.dev/mcp/your-org/your-project"
    }
  }
}
macOS:~/Library/Application Support/Claude/claude_desktop_config.json
Windows:%APPDATA%\Claude\claude_desktop_config.json
4

Restart and Authenticate

After saving the configuration:

  1. Completely quit Claude Desktop (not just close the window)
  2. Reopen Claude Desktop
  3. When prompted, authenticate with your Yavy account
  4. Start asking questions about your documentation!
5

Alternative: Use Skills Packages

Prefer offline access? Generate Skills packages for portable, version-controllable AI knowledge.

Claude Code Plugin (recommended)

Claude Code
/plugin marketplace add yavydev/claude-code
/plugin install yavy-docs@yavy
/yavy:init

Yavy CLI

terminal
npm install -g @yavydev/cli
yavy init

Full plugin guide · CLI reference

Troubleshooting

MCP server not connecting?

Make sure you've completely quit and reopened Claude Desktop after editing the config file. Check that your MCP URL is correct and your Yavy project is active.

Authentication issues?

If the OAuth flow doesn't complete, try clearing your browser cookies for yavy.dev and restarting Claude Desktop. Make sure pop-ups are allowed for the authentication window.

Claude not using the docs?

Try being explicit in your prompt, like "Search my documentation for..." or "Using the indexed docs, explain...". Claude will automatically use Yavy when it recognizes the query relates to your indexed content.

Try Yavy with Claude

Create your Yavy account and start indexing your documentation. You'll have Claude connected in under 5 minutes.