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 URL
  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

Add your Yavy MCP server to Claude Desktop's configuration. Select your operating system below for platform-specific instructions:

Claude Code

Quick Install

Run this command in your terminal to add the MCP server:

terminal
claude mcp add --transport http yavy https://yavy.dev/mcp/<your-project>
or configure manually
.mcp.json

Manual Setup Steps

  1. 1
    Create or open the .mcp.json file in your project directory
  2. 2
    Copy the configuration above and paste it into your .mcp.json file
  3. 3
    Restart Claude Code for changes to take effect
  4. 4
    Verify installation by running claude mcp list

Tip

The .mcp.json file in your project directory makes the MCP server available to your team. Public sources work instantly; private sources prompt for OAuth 2.1 login.

Claude Web (claude.ai)

Setup Custom Connector

  1. 1
    Go to claude.ai and click on your profile icon
  2. 2
    Navigate to Settings > Connectors
  3. 3
    Click Add custom connector
  4. 4
    Fill in the connector details:
    Name:Yavy
    Remote MCP Server URL:https://yavy.dev/mcp/<your-project>
  5. 5
    Click Add to save your connector

Note

Custom connectors are available for Pro, Max, Team, and Enterprise plans only.
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 login
yavy generate your-org/your-project

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.

Ready to Get Started?

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