Help Center/Integrations

Connecting Claude Desktop

Connect Claude Desktop to SDesk so Claude can help you manage support tickets.

What You Can Do

Once connected, you can ask Claude to:

  • "Show me all open tickets"
  • "Read ticket #ABC123"
  • "Draft a reply for this customer's shipping question"
  • "Add a note to the ticket about the refund"
  • "Mark this ticket as resolved"
  • "Create a ticket from this forwarded email"

Prerequisites

  • Claude Desktop installed on your computer
  • Admin access to your SDesk account
  • Your SDesk API key (from Settings → API Access)

Setup Instructions

Step 1: Get Your API Key

  1. In SDesk, go to Settings → API Access
  2. Click Show to reveal your API key
  3. Click Copy Configuration to copy the setup JSON

Step 2: Configure Claude Desktop

  1. Open Claude Desktop
  2. Go to Settings → Developer → Edit Config
  3. Find the mcpServers section in the config file
  4. Paste the configuration you copied from SDesk
  5. Save the file

Step 3: Restart Claude Desktop

Quit Claude Desktop completely and reopen it for the changes to take effect.

Step 4: Test the Connection

In Claude, try:

"List my open support tickets"

If Claude shows your tickets, the connection is working!

Configuration Format

The configuration looks like this:

{
  "sdesk": {
    "command": "npx",
    "args": ["-y", "sdesk-mcp@latest"],
    "env": {
      "SDESK_API_KEY": "your-api-key-here"
    }
  }
}

Troubleshooting

Claude Doesn't See SDesk Tools

  • Ensure you restarted Claude Desktop after editing config
  • Check the config file syntax is valid JSON
  • Verify the API key is correct

Permission Denied Errors

  • Make sure you're using an Admin account's API key
  • Regenerate your API key if needed

Tickets Not Appearing

  • Check that your SDesk account has tickets
  • Verify the API key belongs to the correct shop

Safety Notes

  • Claude can send real emails - When you approve Claude sending a reply, it goes to the customer
  • Review before sending - Always review AI-drafted replies before approving
  • Use internal notes - Ask Claude to add notes instead of replies when you want human review first

Best Practices

  • Start with read-only operations (list, read) before sending replies
  • Use internal notes for drafts that need review
  • Ask Claude to summarize tickets before acting
  • Keep your API key secure and regenerate it if needed