How to Use the Dify.AI SDK MCP in Windsurf

Q: Can Windsurf use the Dify.AI SDK to handle file uploads?

Yes. The uploadfile tool allows you to send local assets to your Dify instance. Windsurf then uses that file data as context for the agent.

Q: Does Windsurf support the Dify.AI SDK for workflow automation?

It does. You can trigger complex logic chains using runworkflow. Cascade will parse the requirements and execute the steps in order.

Q: How do I stop an agent process using Dify.AI SDK inside Windsurf?

If a response is streaming, just trigger the stopchatgeneration tool. It immediately cancels the current request to the Dify backend.

Use the Dify.AI SDK MCP Server to let Windsurf chain complex AI workflows and handle multi-step agent tasks autonomously.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Dify.AI SDK MCP to Windsurf

Create your Vinkius account to connect Dify.AI SDK to Windsurf 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 Dify.AI SDK with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate complex workflows with Windsurf

Trigger your Dify workflows directly from the IDE without manual intervention. Cascade reads your intent and uses `run_workflow` to fire off multi-step pipelines as soon as you define the goal. Stop switching contexts between your code and the Dify dashboard. By passing parameters via `get_workflow_parameters` first, Cascade ensures every execution has the exact data it needs to succeed.

Manage Dify conversations inside the editor

Keep your project context clean by listing or deleting old chats using `get_conversations` and `delete_conversation`. Windsurf maintains a direct line to your history so you can pick up exactly where you left off. When you need historical context, use `get_conversation_messages` to pull previous turns into your current session. It keeps your development flow moving without needing to open a browser.

Full control over multimodal interactions

Send images or files to your apps using `upload_file` and let Windsurf process the output. It handles the handshake so your agent can analyze data and return insights immediately. If a response runs too long, use `stop_chat_generation` to kill the stream. It saves resources and keeps your IDE terminal clutter-free.

Setup guide

Set up Dify.AI SDK MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Dify.AI SDK MCP

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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Dify.AI SDK payment history." If connected, Cascade will call the Dify.AI SDK tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "difyai-sdk-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 Dify.AI. 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 Dify.AI SDK 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 Dify.AI SDK MCP in Windsurf

Open your MCP configuration file or the Cascade settings menu. Add the Dify.AI SDK server under your mcpServers block and refresh the panel to see all 14 tools appear.

Yes. The `upload_file` tool allows you to send local assets to your Dify instance. Windsurf then uses that file data as context for the agent.

It does. You can trigger complex logic chains using `run_workflow`. Cascade will parse the requirements and execute the steps in order.

Your chat history remains on your Dify server. The MCP server only acts as a bridge, reading conversation logs via `get_conversation_messages` when you request them.

If a response is streaming, just trigger the `stop_chat_generation` tool. It immediately cancels the current request to the Dify backend.

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