Troubleshooting

This page covers the most common issues when connecting an AI client to Klarify through the Model Context Protocol.

The AI client cannot find any Klarify tools

If your AI client reports that no Klarify tools are available, the connector is not active.

• Confirm the endpoint is https://mcp.klarify.biz/mcp exactly. A typo or missing path segment causes the connection to fail silently.
• Confirm you completed the browser sign-in step. Until you sign in, no tools are exposed.
• Restart the AI client and re-open the conversation.

I see fewer tools than I expect

The MCP server only registers tools your Klarify role allows. If you are signed in as an Employee, you will not see administrative tools such as create_employee or delete_department.

To see admin tools, sign in as a user with an admin role (Org Admin, Super Admin, Account Manager, or Account Owner). See Permissions and roles for the full matrix.

A tool call returns “permission denied” or similar

Tool registration is one layer of access control; content-level permissions are another. Even if a tool is registered for your session, the underlying record may require additional access.

For example, an Org Admin who has not been granted access to a specific document cannot read that document, even through the AI client. Folders themselves are visible to all active members; access is enforced per document. Grant the required document access in the Klarify app and try again.

My session expired or I need to sign in as a different user

Each new connection to the Klarify MCP server revokes the previous session and forces a fresh sign-in screen.

To switch users:

1. Remove the Klarify connector from your AI client.
2. Add the connector again with the same endpoint.
3. Sign in as the new user when the browser opens.

A bulk CSV import partially failed

The bulk_create_* tools return a result with created, failed, and errors per row. Common causes of row-level failures:

• A required column is missing or misspelled in the CSV header
• A referenced ID (for example, region_id or department_id) does not exist
• A unique field (for example, employee email) is already in use

Fix the offending rows and re-run the import. Successfully imported rows are not duplicated.

See CSV bulk import for the required columns of each bulk tool.

Still stuck?

Contact Klarify support at support@klarify.biz with:

• The AI client you are using (Claude Desktop, Microsoft Copilot Studio, or other)
• The exact prompt or tool name that failed
• Your Klarify organization and role