DeepSeek MCP Server for Claude Desktop: Setup & Config

What you can do with DeepSeek in Claude Desktop

Pick it for explicit DeepSeek V4 controls plus model, balance, and in-memory conversation utilities.

• Generate single-turn or multi-turn DeepSeek chat responses
• Perform fill-in-the-middle text completion with V4 Pro

Before you start: DeepSeek in Claude Desktop

• npx
• A DeepSeek API key for local mode
• An MCP-compatible client

This is the local stdio launch. A hosted HTTP alternative is documented at https://deepseek-mcp.ragweld.com/mcp and requires its own bearer token; it is not needed for this local configuration.

DeepSeek Claude Desktop configuration

1. Choose Claude Desktop configuration scope

   For DeepSeek MCP Server, open macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json. Merge under mcpServers via Settings → Developer → Edit Config when available.

2. Add DeepSeek MCP Server to Claude Desktop

   Use the deepseek-mcp-server entry below in mcpServers. Keep DeepSeek MCP Server's documented stdio connection fields and your other Claude Desktop entries.

3. Check DeepSeek MCP Server in Claude Desktop

   DeepSeek MCP Server: Fully quit and reopen Claude Desktop; check developer diagnostics.

{
  "mcpServers": {
    "deepseek-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "deepseek-mcp-server"
      ],
      "env": {
        "DEEPSEEK_API_KEY": "<DeepSeek provider API key>"
      }
    }
  }
}

DeepSeek tools available to Claude Desktop

DeepSeek's stored tool list documents 7 tools; compare it with Claude Desktop's connected tool list, because the stored list is not a live check.

chat_completion

When Claude Desktop requests chat_completion from DeepSeek, review the action before approving it.

Generate DeepSeek V4 chat responses from a message or conversation history.

completion

When Claude Desktop requests completion from DeepSeek, review the action before approving it.

Generate V4 Pro fill-in-the-middle text from a prompt and suffix.

create_response

When Claude Desktop requests create_response from DeepSeek, review the action before approving it.

Create a stateless Responses API result with optional instructions, reasoning controls, and tools.

list_models

When Claude Desktop requests list_models from DeepSeek, review the action before approving it.

Retrieve available DeepSeek model identifiers.

get_user_balance

When Claude Desktop requests get_user_balance from DeepSeek, review the action before approving it.

reset_conversation

When Claude Desktop requests reset_conversation from DeepSeek, review the action before approving it.

list_conversations

When Claude Desktop requests list_conversations from DeepSeek, review the action before approving it.

DeepSeek: full stored tool descriptions

Troubleshooting DeepSeek in Claude Desktop

• Fully quit and reopen Claude Desktop for DeepSeek MCP Server. If npx deepseek-mcp-server (Node.js/npm) is missing, check the desktop process's PATH, which may differ from your terminal.
• In Claude Desktop's DeepSeek MCP Server entry, check DEEPSEEK_API_KEY. Keep secrets out of shared screenshots and repositories.
• DeepSeek MCP Server uses stdio here: Claude Desktop must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Conversation history is limited to the current process memory
• Known limitation: Provider credentials or a hosted bearer token are required
• Known limitation: Responses API tool appears in structured data but not the README tool list
• General Claude Desktop troubleshooting lives in the /clients/claude-desktop guide.

Frequently asked questions