How to Use the Dify MCP in Claude Code

Q: How do I run a Dify chat query from Claude Code?

You can ask Claude Code to run the chat tool directly in your terminal. It executes the query headlessly and prints the response, which you can easily redirect to a local log file.

Q: Can I automate Dify file uploads using Claude Code?

Yes, Claude Code runs the uploadfile tool to send any local asset or build artifact directly from your shell. This is perfect for scripting cron jobs that sync your data sources daily.

Q: How does Claude Code list conversations from Dify?

The agent calls listconversations to output active session metadata directly to your terminal. This MCP capability lets you quickly grab IDs to inspect specific message logs.

Q: Can Claude Code fetch app parameters?

Yes, the agent runs getparameters to retrieve system prompts and model configurations. It displays these parameters as raw text, allowing you to quickly inspect them in your terminal.

Pipe Dify chat logs, configuration parameters, and files directly through Claude Code for headless terminal automation.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Dify MCP to Claude Code

Create your Vinkius account to connect Dify to Claude Code 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 with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless Dify Testing in the Terminal

The `chat` tool enables Claude Code to query your Dify applications directly from the command line. Connecting this MCP setup allows your terminal agent to process logs or system alerts in real time. You can pipe script outputs straight into a chat session without running slow manual API calls. After sending a query, Claude Code relies on `list_messages` to dump the conversation transcript directly to stdout. This makes it simple to grep for specific errors or pipe the history into other command-line utilities.

Automate CI/CD Knowledge Base Updates

The `upload_file` tool lets Claude Code push build artifacts, deployment logs, or schemas directly to Dify from your terminal. SREs can automate this step in a GitHub Action to keep production knowledge bases updated with every release. If a build pipeline triggers a model regression, Claude Code uses `get_parameters` to audit the application configuration. It outputs the system prompt parameters directly to your shell, letting you diff them against previous versions.

Audit Sessions via Claude Code MCP Server

The `list_conversations` tool allows Claude Code to fetch active session IDs and inspect live production traffic from the command line. This gives backend developers a fast way to monitor agent health without loading a web dashboard. When debugging a live issue, you can use the `feedback` tool to mark bad interactions directly from your terminal session. This updates your training data on the fly, keeping your engineering loop fast and keyboard-driven.

Setup guide

Set up Dify MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see dify-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Dify transactions." It will automatically discover and invoke the available Dify tools.

Terminal

claude mcp add --transport http dify-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Dify 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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "dify-mcp": {
      "type": "url",
      "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. 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 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 MCP in Claude Code

You can ask Claude Code to run the `chat` tool directly in your terminal. It executes the query headlessly and prints the response, which you can easily redirect to a local log file.

Yes, Claude Code runs the `upload_file` tool to send any local asset or build artifact directly from your shell. This is perfect for scripting cron jobs that sync your data sources daily.

The agent calls `list_conversations` to output active session metadata directly to your terminal. This MCP capability lets you quickly grab IDs to inspect specific message logs.

Yes, the agent runs `get_parameters` to retrieve system prompts and model configurations. It displays these parameters as raw text, allowing you to quickly inspect them in your terminal.

All transport occurs over secure, ephemeral MCP connections managed by Vinkius. Your application parameters and conversation transcripts are processed in memory and never written to persistent third-party storage.

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