Couchbase (Vector & NoSQL) Connector for AI agents.
7 live capabilities
Query NoSQL data and perform KNN vector searches on your Couchbase cluster.
Waiting for input…
Why people use Couchbase (Vector & NoSQL)
Couchbase (Vector & NoSQL) for faster RAG development
This Connector puts that entire process into a single conversation. You can ask your agent to run a vector_search and see the scores immediately, or use execute_n1ql_query to pull the exact JSON you need. You get the data you need right where you're working, without the manual copy-pasting.
What Vinkius changes
You get a direct conversation line to your NoSQL and vector data without touching a terminal.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Debugging a RAG pipeline
An AI engineer notices poor retrieval results and asks the agent to use vector_search to check the similarity scores of the top 5 results.
- Real-world use case 02
Auditing a new production environment
A data architect needs to verify the setup and asks the agent to use list_buckets and list_scopes to confirm the schema matches the staging plan.
- Real-world use case 03
Quick JSON data extraction
A product manager wants to see the structure of a specific user profile and asks the agent to use get_document to pull the JSON.
Complete set · 7capabilities
The complete Couchbase (Vector & NoSQL) capability set.
These are the exact actions your AI can choose when you ask it to work with Couchbase (Vector & NoSQL).
01—04
4 capabilities in this set.
Part of 7 available through Couchbase (Vector & NoSQL).
- 01 Capability
Execute n1ql query
Run N1QL queries to get specific JSON payloads from your buckets. It lets you perform complex data filtering using SQL-like logic.
- 02 Capability
List buckets
See all the routing spaces in your Couchbase DB. This helps you understand the high-level organization of your data.
- 03 Capability
List scopes
Find the limits and objects for your specific scopes and collections. It helps you see exactly what data is accessible.
- 04 Capability
List indexes
See all the active search indexes and rules attached to your data. This is vital for verifying your search configurations.
05—07
3 capabilities in this set.
Part of 7 available through Couchbase (Vector & NoSQL).
- 05 Capability
Vector search
Map structural KNN vector similarities using your existing vector indexes. This is the core capability for similarity-based retrieval.
- 06 Capability
Get document
Pull internal properties for specific Couchbase KV documents using their keys. It gives you an exact look at a single record.
- 07 Capability
Fts search
Match query strings against your content trees using full-text search indexes. It handles structural text-based extraction.
Set up in minutes
One URL. Then ask Couchbase (Vector & NoSQL) to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Couchbase (Vector & NoSQL) from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_wWaJnEVjNwe96vxf5IajtX1h1rZH9VkCF8KWnsvT/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Couchbase (Vector & NoSQL), and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Couchbase (Vector & NoSQL) for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_wWaJnEVjNwe96vxf5IajtX1h1rZH9VkCF8KWnsvT/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Couchbase (Vector & NoSQL) URL.
- Step 03
Save and start
Save the connection and enable Couchbase (Vector & NoSQL) in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"couchbase-vector-nosql": {
"url": "https://edge.vinkius.com/vk_preview_wWaJnEVjNwe96vxf5IajtX1h1rZH9VkCF8KWnsvT/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Couchbase (Vector & NoSQL)
Open Agent mode in chat and ask: "Using Couchbase (Vector & NoSQL), help me...". 7 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"couchbase-vector-nosql": {
"url": "https://edge.vinkius.com/vk_preview_wWaJnEVjNwe96vxf5IajtX1h1rZH9VkCF8KWnsvT/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Couchbase (Vector & NoSQL)
Ask Copilot: "Using Couchbase (Vector & NoSQL), help me...". 7 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"couchbase-vector-nosql": {
"url": "https://edge.vinkius.com/vk_preview_wWaJnEVjNwe96vxf5IajtX1h1rZH9VkCF8KWnsvT/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Couchbase (Vector & NoSQL)
Open Cascade and ask: "Using Couchbase (Vector & NoSQL), help me...". 7 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"couchbase-vector-nosql": {
"url": "https://edge.vinkius.com/vk_preview_wWaJnEVjNwe96vxf5IajtX1h1rZH9VkCF8KWnsvT/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Couchbase (Vector & NoSQL)
Ask Cline: "Using Couchbase (Vector & NoSQL), help me...". 7 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add couchbase-vector-nosql --transport http "https://edge.vinkius.com/vk_preview_wWaJnEVjNwe96vxf5IajtX1h1rZH9VkCF8KWnsvT/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Couchbase (Vector & NoSQL)
Ask Claude: "Using Couchbase (Vector & NoSQL), show me...". 7 tools are ready
Where the request belongs
Work Couchbase can move forward.
This is for the engineers and architects who are tired of manual schema audits and the headache of debugging RAG pipelines. It's for people who need to move fast between data exploration and production deployment.
AI Engineer
Debugging vector similarity scores and refining RAG prompts by inspecting real-time data.
Data Architect
Auditing NoSQL structures and verifying collection organization across different environments.
Database Administrator
Monitoring search indexes and running N1QL queries to ensure data consistency.
Product Manager
Prototyping search features and checking JSON schemas without waiting on a dev ticket.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsMongoDB Atlas Vector Search
Manage vector storage via MongoDB Atlas. perform similarity searches, query MQL documents, and audit collections.
MyScale (SQL Vector Database API)
Manage MyScale vector databases via SQL. execute queries, perform vector searches, and manage indices directly from any AI agent.
Supabase Vector
Connect your AI to Supabase Vector. Execute pgvector semantic searches, manage embeddings, and run relational database queries directly from your terminal.
Qdrant
Empower your AI to interact directly with your Qdrant vector database. query clusters, perform similarity searches, and manage collections effortlessly.
LanceDB (Serverless Vector DB)
Manage vectorized data via LanceDB. perform similarity searches, create tables, and manage multi-modal embeddings.
Milvus (Open-Source Vector Database)
Manage vector storage via Milvus. perform ANN searches, query scalar entities, and audit collections.
Bring your own AI
Change the model, client or framework. Keep Couchbase connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Couchbase.
The practical details behind the request, access and result.
Can I use the Couchbase (Vector & NoSQL) MCP to manage my RAG application?
Yes. It allows your AI agent to perform KNN vector searches and N1QL queries, making it much easier to debug and refine how your AI retrieves information from your database.
Does the Couchbase (Vector & NoSQL) MCP work with my self-hosted cluster?
It works with both Couchbase Capella and self-hosted clusters. You just need to provide your URL and credentials to give your agent access.
Can I use this to see my database structure?
Absolutely. You can ask the agent to list your buckets, scopes, and collections to get a clear picture of how your data is organized without running manual commands.
Is the Couchbase (Vector & NoSQL) MCP good for auditing indexes?
Yes, it's a great way to quickly enumerate all your search indexes and verify your vector definitions to ensure your search logic is set up correctly.
Can my AI agent actually run N1QL queries?
Yes, the Connector allows your agent to execute N1QL queries and return the JSON results directly in your chat, saving you from writing and testing queries manually.
How do I connect my Couchbase data to my AI client using this?
Once you subscribe on Vinkius, you just enter your database credentials. From there, your AI client can start querying your NoSQL and vector data immediately.
Can my agent perform K-Nearest Neighbor (KNN) vector searches in Couchbase?
Yes. Provide the search index name, the vector embedding array, and the number of results (k). The agent uses Couchbase's native vector capabilities to locate the most semantically similar documents in your cluster.
How do I execute a N1QL query through the agent?
Use the 'execute_n1ql_query' capability and provide your SQL-like statement. The agent will fetch the structural JSON blocks directly from Couchbase, allowing you to perform complex data retrieval using familiar SQL syntax.
Can I search documents using full-text query logic?
Absolutely. The 'fts_search' capability leverages Couchbase's Full-Text Search (FTS) engine. Provide an index name and a boolean query string to perform structural text-based extraction across your document trees.
One connection away
Give your agent a direct line to Couchbase.
Connect Couchbase once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available