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
- In SDesk, go to Settings → API Access
- Click Show to reveal your API key
- Click Copy Configuration to copy the setup JSON
Step 2: Configure Claude Desktop
- Open Claude Desktop
- Go to Settings → Developer → Edit Config
- Find the
mcpServerssection in the config file - Paste the configuration you copied from SDesk
- 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