How to Use the FastGPT MCP in Claude

Q: How does Claude Desktop connect to the FastGPT MCP Server?

You add the server config to your local claudedesktopconfig.json file. Claude Desktop launches the MCP server as a subprocess, giving your agent immediate access to FastGPT tools like listdatasets and pushdatasetdata.

Q: What happens when I ask Claude Desktop to delete FastGPT data?

Your Claude Desktop agent invokes deletedatasetdata with the exact ID you target. The deletion happens instantly on your FastGPT instance, removing the vectors from your active knowledge base.

Q: Can Claude Desktop generate embeddings using FastGPT?

Yes, the desktop agent calls the FastGPT getembeddings tool to generate vector representations of your text. You can use these vectors for local search tasks or to verify how FastGPT indexes your inputs.

Feed files from your machine into FastGPT datasets and run semantic searches directly inside Claude Desktop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect FastGPT MCP to Claude Desktop

Create your Vinkius account to connect FastGPT to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup FastGPT with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Feed local files to FastGPT datasets using Claude Desktop

Your agent uses `push_dataset_data` to send local files straight to your FastGPT datasets from Claude Desktop. This stops you from copying raw documentation into web browsers just to update your knowledge bases. You get to control your raw documents locally while FastGPT handles the heavy vector indexing. Your Claude Desktop agent monitors local directory updates and triggers `update_dataset_data` to keep your remote FastGPT knowledge base perfectly synced with your local workspace.

Run real-time FastGPT semantic search in your chat

Your agent calls `search_dataset_data` to run semantic searches across your FastGPT knowledge bases directly inside your Claude Desktop chat. This fetches context from your existing datasets during active conversations to pull relevant chunks based on your desktop chat prompt. You don't have to guess which FastGPT dataset holds the answer. The Claude Desktop agent runs `list_datasets` to find the right knowledge base, inspects details with `get_dataset_detail`, and queries the exact files needed to solve your problem.

Control your FastGPT apps directly from Claude Desktop

Your agent runs `list_apps` to fetch and display your active FastGPT application configurations inside Claude Desktop. This integration lets you manage your remote FastGPT setups without switching tabs. You can test FastGPT prompt variations instantly. Your desktop agent triggers `chat_completions` to run test queries against your apps, checking intermediate steps and context tracking to debug performance on the fly.

Setup guide

Set up FastGPT 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 FastGPT 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 FastGPT 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 fastgpt-mcp.

json

{
  "mcpServers": {
    "fastgpt-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 FastGPT. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect FastGPT now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about FastGPT MCP in Claude Desktop

You add the server config to your local `claude_desktop_config.json` file. Claude Desktop launches the MCP server as a subprocess, giving your agent immediate access to FastGPT tools like `list_datasets` and `push_dataset_data`.

Yes, you can paste the Vinkius remote MCP server URL into the Integrations menu on claude.ai. This lets your web agent run `search_dataset_data` across your FastGPT knowledge bases without running any local code.

Your Claude Desktop agent invokes `delete_dataset_data` with the exact ID you target. The deletion happens instantly on your FastGPT instance, removing the vectors from your active knowledge base.

Yes, the desktop agent calls the FastGPT `get_embeddings` tool to generate vector representations of your text. You can use these vectors for local search tasks or to verify how FastGPT indexes your inputs.

Your raw documents and FastGPT vector data travel through a secure, isolated Vinkius sandbox. Your credentials are never stored in plain text, and your document chunks are transmitted directly to FastGPT via encrypted HTTPS connections.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript