MCP Server

Connect your Testlify workspace to Claude so you can manage assessments and candidates in plain language — list assessments, invite candidates, and pull results without leaving the chat.

What you'll need

A Testlify account with access to the workspace you want to connect.
A Claude plan that supports custom connectors (Pro, Max, Team, or Enterprise). On Team and Enterprise plans, an admin may need to add the connector for the organization.
Claude on the web or desktop app (connector setup is not available on mobile).

Step 1 — Add the custom connector

In Claude, open Settings → Connectors.
Click Add custom connector.
Fill in the dialog:
Don't click Continue yet — first expand Advanced settings (next step).

Field	Value
Name	`Testlify`
MCP server URL	`https://mcp.testlify.com/api/mcp`

⚠️ The URL must be exactly https://mcp.testlify.com/api/mcp , including the /api/mcp path.

Step 2 — Add the OAuth Client ID

Testlify does not support automatic client registration yet, so Claude needs the client ID set manually:

In the same dialog, expand Advanced settings.
Enter:
Click Continue / Save.

Field	Value
OAuth Client ID	`testlify-mcp`
OAuth Client Secret	(leave empty)

If you skip this step, Claude shows: "Automatic client registration isn't supported by Testlify. Edit the connector and add an OAuth Client ID." Edit the connector, add the Client ID above, save, and reconnect — clicking Reconnect alone won't fix it.

Step 3 — Authorize with Testlify

Click Connect on the Testlify connector.
Your browser is redirected to app.testlify.com. Sign in if you aren't already — make sure you're in the workspace you want Claude to access.
Review the requested permissions and click Allow.
You're sent back to Claude and the connector shows as Connected.

Step 4 — Use it in a chat

In a new chat, open the tools / connectors menu (the ⚙️ or paperclip-style icon near the message box) and make sure Testlify is enabled.
Try a prompt:
- "List my active assessments in Testlify."
- "Invite jane@example.com to the Frontend Developer assessment."
- "Show me the result for candidate John Doe on the QA assessment."

Claude will ask for your confirmation before actions like inviting candidates.

What Claude can do once connected

Tool	What it does
Get all assessments	List assessments with filters and pagination
Get single assessment	Fetch one assessment's details by ID
Create assessment from template	Spin up a new assessment from a Testlify template
Invite candidates	Bulk-invite up to 100 candidates to an assessment
Get all candidates	List candidates across the workspace
Get candidate list by assessment	List candidates for one assessment
Get candidate result	Detailed scores and result for a candidate

Permissions (OAuth scopes): assessments:read , candidates:read , candidates:write . Claude can only access data the authorizing user can access in Testlify.

Troubleshooting

Symptom	Fix
"Automatic client registration isn't supported by Testlify… add an OAuth Client ID"	Edit the connector → Advanced settings → set OAuth Client ID to `testlify-mcp` (secret empty) → save → Reconnect. The Reconnect button alone won't resolve this.
"Couldn't register with Testlify's sign-in service"	Check the server URL is exactly `https://mcp.testlify.com/api/mcp` , then add the OAuth Client ID as above.
"Connection issue — your connection to Testlify stopped working"	Click Reconnect and complete the Testlify authorization again.
Authorized the wrong workspace	Disconnect the connector, sign in to the correct workspace at app.testlify.com, then reconnect.
Tools don't appear in chat	Open the chat's tools menu and toggle Testlify on; then start a new message.

Disconnecting

Settings → Connectors → Testlify → ⋮ → Remove (or Disconnect). This revokes Claude's access immediately; you can reconnect at any time.

Connect Testlify to Claude (Custom Connector)