How to Use the Deskpro MCP in Claude Code

Q: How do I connect the Deskpro MCP Server to Claude Code?

Run claude mcp add --transport http deskpro -- in your terminal. All connection flags must precede the server name. Your configuration saves automatically to /.claude.json.

Q: Can Claude Code read specific Deskpro tickets?

Terminal agents fetch exact thread details using the getticketdetails tool. You just provide the ID, and the CLI outputs the entire conversation history into your shell.

Q: How do I access knowledge base articles from the terminal?

Finding documentation requires a quick search with listkbarticles. Once you locate the right document, the agent extracts the raw text via getarticlecontent.

Claude Code drives your Deskpro helpdesk from the terminal, automating ticket updates and API checks via shell scripts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Deskpro MCP to Claude Code

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless ticket operations

The Deskpro MCP Server brings customer support directly into your CLI environment. SREs can pipe server alerts straight to `create_new_helpdesk_ticket` without touching a browser. Managing incidents becomes a purely terminal-based workflow. You instruct Claude Code to pull active outages with `list_helpdesk_tickets`, and it updates the statuses using `update_ticket_properties` as systems recover.

Automated infrastructure audits

Verifying support system uptime through the MCP Server is critical during major deployments. Your terminal agent runs `check_api_health` as part of your CI/CD pipeline to ensure the helpdesk is reachable. Validating event triggers happens just as fast. Claude Code calls `list_configured_webhooks` to confirm your alerting endpoints are active before signing off on a production release.

Claude Code user and agent mapping

Incident response via this MCP Server requires knowing exactly who is on call and which customers are affected. The CLI executes `list_helpdesk_agents` to find available staff members for escalation. Connecting issues to specific clients takes seconds. The agent queries `get_user_profile` to grab the reporter's details, then maps them to a corporate account using `list_user_organizations`.

Setup guide

Set up Deskpro 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 deskpro-mcp with a green status indicator.
3

Start using tools

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

Terminal

claude mcp add --transport http deskpro-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 Deskpro 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": {
    "deskpro-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 Deskpro. 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 Deskpro 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 Deskpro MCP in Claude Code

Run `claude mcp add --transport http deskpro -- ` in your terminal. All connection flags must precede the server name. Your configuration saves automatically to `~/.claude.json`.

Terminal agents fetch exact thread details using the `get_ticket_details` tool. You just provide the ID, and the CLI outputs the entire conversation history into your shell.

Sorting by status and department works natively. Claude Code passes those exact filters to `list_helpdesk_tickets` when you need a focused view of the queue.

Finding documentation requires a quick search with `list_kb_articles`. Once you locate the right document, the agent extracts the raw text via `get_article_content`.

Vinkius manages the MCP Server connection securely without storing credentials locally. Webhook URLs, customer emails, and agent profiles remain ephemeral and never leak into model training data.

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