drafty
Freshdesk logo

Build a Freshdesk support dashboard with Claude

Connect the Freshdesk MCP server to Claude, ask for an SLA and backlog dashboard from your live tickets, and publish it to a link your team comments on directly — no BI tool, no screenshots pasted into Slack.

What you'll build
A self-contained support dashboard — open backlog, SLA compliance, first-response and resolution times, tickets by priority and group, recent breaches — generated by Claude from your real Freshdesk data, then published to a drafty.im/canvas/… link. Your team clicks the exact tile or number they want changed and leaves a note. Claude reads the comments and ships a revised version to the same URL.

This is an end-to-end example: connect a data source over MCP, generate a dashboard from live numbers, and close the review loop on one link. Total time, start to shared link, is under fifteen minutes. The same shape works for any of the other examples — only the connection step changes.

Here's the finished dashboard, published to a canvas — click any tile or number to leave a comment, exactly as your team would:

Live canvas — comment on any elementOpen ↗

The three moving parts

  1. The Freshdesk MCP server gives Claude read access to your helpdesk — tickets, conversations, agents, groups, SLA policies — through a controlled set of tools. The API key it uses inherits the role of the agent it belongs to, so you decide what it can touch.
  2. Claude pulls the numbers and writes a single self-contained HTML dashboard. You iterate on it in the artifact panel until it's right.
  3. Drafty turns that HTML into a stable link your team reviews. Comments pin to the exact element; Claude ships the fix to the same URL.

The generation step is fast now. The part this example is really about is the third one — getting the dashboard in front of people without losing their feedback to a screenshot circled in Preview.

Step 1 — Connect the Freshdesk MCP server

Freshdesk runs an MCP server at https://<your-freshdesk-domain>/mcp — your own helpdesk domain, e.g. acme.freshdesk.com. It authenticates with your Freshdesk API key, passed in the Authorization header. You connect once.

In Claude Code:

claude
claude mcp add freshdesk --transport http https://<your-freshdesk-domain>/mcp --header "Authorization: <api-key>"

Replace <your-freshdesk-domain> with your helpdesk host and <api-key> with the API key from your Freshdesk profile (Profile settings → "Your API Key"). Then run /mcp inside Claude Code to confirm the server connected.

In Claude Desktop: open Settings → Developer → Edit Config and add the Freshdesk server under mcpServers, using mcp-remote to reach it:

claude
"freshdesk": { "command": "npx", "args": ["-y", "mcp-remote", "https://<your-freshdesk-domain>/mcp", "--header", "Authorization:<api-key>"] }
Safety first
A Freshdesk API key inherits the permissions of the agent it belongs to — there's no separate scope. For a read-only dashboard, generate the key from an agent assigned a view-only / reporting role, so the MCP server can read tickets and metrics but can't reply, edit, or delete. Never paste the key into a committed config file or a repo. The dashboard only reads; it has no reason to hold write permissions.

Step 2 — Pull the numbers

Ask Claude in plain language. It uses the MCP server's read tools to fetch real ticket data:

claude
Using the Freshdesk MCP server, pull everything we need for a support dashboard: count of open and pending tickets (the backlog), SLA compliance rate for the last 30 days, average first-response time and average resolution time, ticket counts broken down by priority and by group, and the most recent SLA breaches with their ticket IDs. Summarize the figures before you build anything.

Claude calls Freshdesk, returns the figures, and you sanity-check them against your Freshdesk reports before going further. This is the moment to catch a wrong assumption — a status you're not counting as "open," business-hours vs. calendar-hours SLA, a group filter you didn't expect — while it's cheap.

Step 3 — Build the dashboard

Once the numbers look right, ask for the artifact:

claude
Build a single self-contained HTML dashboard from those figures. Open backlog as the hero number with week-over-week change, then tiles for SLA compliance, average first-response time, and average resolution time. A bar chart of tickets by priority, a breakdown by group, and a recent-SLA-breaches table at the bottom. Clean, no external dependencies — inline the CSS and any chart code.

Claude renders it live in the artifact panel. Iterate in place — you're not regenerating from scratch:

Step 4 — Publish to Drafty for review

A Claude artifact link is a preview, not a stable URL — iterate the artifact and the link you already sent now shows the old version. Ask Claude to publish it to a Drafty canvas instead, so the link you share always stays current:

claude
Publish this dashboard to Drafty as a canvas and give me the shareable link.

Claude pushes the dashboard and hands back a drafty.im/canvas/… link that renders on any device. Send it — your team opens it in a browser, no login and no Claude account needed.

Step 5 — The review loop

This is the part that's not obvious until you've done it once.

A reviewer clicks the specific tile, chart, or number they want changed and leaves a pinned comment — "this SLA figure looks high, are we counting tickets that breached over the weekend?" The comment is anchored to that element, not floating in a Slack thread. Claude reads the comments through the CLI, reruns the relevant Freshdesk query if needed, and pushes a revised dashboard to the same URL. The reviewer refreshes and sees the change; the thread stays attached to the element.

The mechanic matters because of what it removes. A Slack message about a chart produces "the number on the left looks wrong." A pinned comment on the actual tile produces "this — measure SLA against business hours, not calendar hours." One of those produces a correct revision; the other produces a guess.

Keeping it fresh

An MCP-generated dashboard is a snapshot — it holds the numbers Claude pulled when it built it; it doesn't re-query Freshdesk when someone opens the link. For a weekly review or a stand-up snapshot, that's fine.

To make it a live canvas that always shows today's figures, copy this prompt — Claude sets up the refresh for you and schedules it to run on its own:

claude
Turn this Freshdesk dashboard into a live canvas: every morning, re-pull the latest backlog, SLA, and response-time numbers from Freshdesk via the MCP server, rebuild the dashboard, and push a new version to the same canvas URL so the link always shows today's figures. Schedule it to run daily on its own.

The link stays stable while the content updates underneath it — see keeping a canvas updated automatically.

What to watch for

Freshdesk dashboard with Claude — FAQ

Where does the Freshdesk MCP server get its credentials?
From your Freshdesk API key, passed in the Authorization header when you add the server. Freshdesk's MCP integration authenticates by API key only — there's no OAuth yet. The key inherits the permissions of the agent it belongs to, so generate it from a view-only / reporting agent and never commit it to a repo.
Is the dashboard live or a snapshot?
A snapshot. It contains the numbers Claude pulled when it built the file; it does not re-query Freshdesk when someone opens the link. To refresh it, ask Claude to repull and re-push to the same URL — or put that on a daily schedule so the stable link always shows current numbers.
Can my team comment without a Freshdesk or Claude account?
Yes. The dashboard is published to a Drafty canvas link that renders in any browser. Reviewers click the exact element they want changed and leave a pinned comment with no login required. Only the person connecting Freshdesk needs access to the account.
Is it safe to give Claude access to my Freshdesk account?
Use an API key from an agent with a view-only / reporting role, and a support dashboard never needs more than that. Every tool call is mediated by the MCP server, and in Claude you approve actions. Don't use an admin's key for a read-only reporting task.
How is this different from Freshdesk's own Analytics?
Freshdesk Analytics queries live data against the report model you maintain — the right choice for governed, recurring reporting. This approach is for a fast, shareable snapshot you can spin up in minutes and iterate by talking to Claude, then collect feedback on inline. Different jobs: one is a standing system, the other is a quick reviewable deliverable.