Connect Claude and other MCP clients to Skillset to work with tickets and knowledge articles from a chat or coding session.
| Setting | Value |
|---|---|
| Server URL | https://app.skillset.co/api/v1/mcp |
| Transport | Streamable HTTP |
| Authentication | OAuth 2.1 in the browser; clients register automatically |
| Access | Your Skillset account, limited to the permissions you approve |
Requirements:
app.skillset.co and accept any pending invitation first.Register the server:
claude mcp add --transport http skillset https://app.skillset.co/api/v1/mcp
Then start Claude Code, run /mcp, select skillset, and finish signing in
in the browser window that opens.
More options: Claude Code MCP documentation.
Skillset as the name and the server URL above.Note: On Claude Team and Enterprise plans, an owner may need to allow custom connectors before members can add one. See custom connectors in Claude.
Add a remote server with the URL https://app.skillset.co/api/v1/mcp. You do
not need a client ID, client secret, or API key; the client registers itself
during the first sign-in.
The first time the client calls Skillset:
| Scope | Grants |
|---|---|
knowledge:read | Search and read knowledge articles |
tickets:read | List and read tickets |
tickets:write | Create and update tickets |
tickets:delete | Delete tickets |
Note: Every call is checked against both the approved scopes and your current role in the workspace. Scopes never add access your account does not already have, and tickets:write does not include tickets:read.
Every tool except contexts_list takes a tenant_id and a workspace_slug.
Get both from contexts_list first; most clients do this on their own.
Workspaces
| Tool | Description | Try asking |
|---|---|---|
contexts_list | Organizations and workspaces you can access | "Which Skillset workspaces do I have?" |
Tickets
| Tool | Description | Try asking |
|---|---|---|
tickets_list | List tickets, newest first, filtered by status, priority, or text q | "Show high-priority tickets in IT Support" |
tickets_get | One ticket by UUID or short ID such as TKT-42 | "Summarize TKT-118" |
tickets_create | New ticket with title, description, priority | "Open a ticket for the broken badge reader in Lobby B" |
tickets_update | Change title, description, status, or priority | "Set TKT-118 to resolved" |
tickets_delete | Move a ticket to the workspace Trash for 30 days | "Delete the duplicate ticket TKT-120" |
Knowledge
| Tool | Description | Try asking |
|---|---|---|
knowledge_search | Keyword search across articles you can read | "Find our VPN setup guide" |
knowledge_get | Full text of one article by article_id | "Open that article and list the steps" |
Knowledge access is read-only. tickets_create requires the workspace to accept
API tickets; see Limits below.
You: How do I set up VPN on a new laptop? Check our IT Support docs.
Claude: → contexts_list
← skillset: customer-success, it-support
→ knowledge_search workspace_slug=it-support q="VPN setup"
← 3 results; top match "Connect to the corporate VPN"
→ knowledge_get article_id=…
← full article
Here are the steps from "Connect to the corporate VPN": …
| Limit | Value |
|---|---|
| Rate limit | 120 reads and 30 writes per minute per account, shared with the REST API |
tickets_list page size | limit 1–200 (default 50), with offset |
knowledge_search page size | limit 1–25 (default 10), with offset |
| Ticket creation | The workspace must enable Set-up → Channels → API |
| Knowledge | Read-only |
Tool errors include a stable code and a request_id.
| Status | Code | Meaning | Fix |
|---|---|---|---|
| 401 | unauthorized | Token expired or revoked | Reconnect and sign in again |
| 403 | insufficient_scope | A required scope was not approved | Reconnect and approve the scope |
| 403 | forbidden | Not a member of that workspace | Check your membership in Skillset |
| 403 | api_intake_disabled | Workspace does not accept API tickets | Ask an admin to enable Set-up → Channels → API |
| 404 | not_found | Ticket, article, or workspace not found | Check the ID and workspace |
| 429 | rate_limited | Rate limit reached | Wait for the retry interval in the error |
| 503 | verification_unavailable | Sign-in could not be verified | Retry shortly |
If the client cannot connect at all, confirm the server URL is exact and that
the client supports OAuth for remote servers. For anything else, contact
Skillset support with the request_id.
Remove the Skillset connector in your client. To revoke the grant on the server as well, contact Skillset support.