How to Use the R2R MCP in Claude

Q: Can R2R manage document collections in Claude Desktop?

Yes, the listcollections tool lets you view all active groups. You can then use those collection IDs to narrow down your RAG queries.

Q: Does Claude Desktop R2R integration support document health checks?

Absolutely. Use gethealth to confirm the R2R backend is operational. It returns a status code so you know your connection is solid.

Q: How do I see what is indexed in R2R via Claude Desktop?

Run listdocuments to pull a full inventory of your ingested files. You can then copy a document ID to fetch specific details with getdocument.

Connect R2R to Claude Desktop to query your vector database and manage documents directly from your chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect R2R MCP to Claude Desktop

Create your Vinkius account to connect R2R to Claude Desktop — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup R2R with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run RAG queries inside Claude Desktop

Use the `rag_query` tool to pull precise, context-aware answers from your ingested files. Your AI client retrieves relevant document chunks and synthesizes a response based on your actual data. Stop digging through folders manually. This MCP server handles the retrieval logic so you get accurate citations and project insights without leaving your workspace.

Search vector data with Claude Desktop

Execute semantic searches using `search` to find document segments that match your intent, not just keyword overlaps. The engine maps your natural language questions to the underlying vector space. It works instantly. Just ask your agent to find specific information, and it hits the R2R backend to surface the right content.

Monitor and manage R2R state

Check the status of your pipeline with `get_health` to ensure the server is ready for tasks. If you need to audit what is currently in the system, use `list_documents` or `list_collections` to view your data inventory. You can also pull specific file details with `get_document` when you need to verify metadata. It keeps your AI client informed about exactly what data is available for processing.

Setup guide

Set up R2R MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The R2R MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the R2R MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under r2r-mcp.

json

{
  "mcpServers": {
    "r2r-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by R2R. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.