X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Persona to Claude

Connect Claude Web, Desktop and Cowork to Persona MCP. Get all pending verification cases, trigger a new kyc verification for user, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Persona logoPersona
Api Key

Persona offers identity infrastructure to automate user verification and compliance. It helps organizations securely verify users and reduce fraud risk.

69 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Persona account to Claude via Composio Connect, enabling it to get all pending verification cases, trigger a new KYC verification for user, list users who failed identity checks, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Persona with

OpenAI Agents SDKClaude Agent SDKClaude CodeCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Connecting Persona to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Persona account

Back in Claude, ask it to connect to Persona or give it any Persona-related task.

For example, ask Claude to:

  • "Get all pending verification cases."
  • "Trigger a new KYC verification for user."
  • "List users who failed identity checks."

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Persona account is ready to use.

What is the Persona Claude Connector, and what's possible with it?

The Persona MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Persona account. It provides structured and secure access so your agent can perform Persona operations on your behalf.

Troubleshooting

1. Why does Claude not use the Composio connector for Persona?

The connector can show as connected, but Claude must use it in each Persona conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Persona again.

2. Why does Claude show an MCP server error before Persona connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Persona.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Persona.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Persona authorization link not work?

The Composio connector is one server. Your Persona account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Persona connection.
  • Composio creates a fresh Persona authorization link.
  • Open that link in your browser and finish the Persona sign-in.

4. Why do Persona actions fail after they worked before?

The Persona connection can expire or lose permission.

  • Ask Claude to inspect the Persona connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Persona account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Persona.
  • If the action still fails with a permission error, check that the connected account has that permission in Persona itself.

5. How do I switch to a different Persona account?

Claude can manage the Persona connection for you.

  • Ask Claude to disconnect or delete the current Persona account.
  • Ask Claude to connect Persona again.
  • Open the new Composio authorization link for Persona.
  • Sign in with the other Persona account in the browser.
  • After the account connects, ask Claude to retry the Persona task.

6. Why is my Persona connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Persona connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Persona tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Persona.
TOOLS

Supported Tools

Every Persona action and event your agent gets out of the box.

Add Tag to Account

Tool to add a tag to an Account in Persona.

Archive Browser Fingerprint List Item

Tool to archive a browser fingerprint list item in Persona.

Archive Country List Item

Tool to archive a Country List Item by ID.

Archive a Geolocation List Item

Tool to archive a geolocation list item from Persona.

Archive Government ID Number List Item

Tool to archive a Government ID Number List Item.

Archive a Name List Item

Tool to archive a name list item in Persona.

Archive a webhook

Tool to archive a Persona webhook by its ID.

Archive Email Address List Item

Tool to archive an Email Address List Item in Persona.

Archive IP Address List Item

Tool to archive an IP address list item in Persona.

Archive Phone Number List Item

Tool to archive a phone number list item in Persona.

Archive String List Item

Tool to archive a String List Item in Persona.

Clone Webhook

Tool to clone an existing Persona webhook.

Consolidate Accounts

Tool to consolidate multiple source accounts into a single destination account.

Create an Account

Tool to create an account in Persona.

Create IP Address List Item

Tool to create an IP Address List Item in Persona.

Create Country List Item

Tool to create a country list item in Persona.

Create Generic Document

Tool to create a generic document in Persona.

Create Email Address List Item

Tool to create an email address list item in Persona.

Create Government ID Number List Item

Tool to create a new government ID number list item in Persona.

Create Name List Item

Tool to create a new name list item in Persona.

Create Phone Number List Item

Tool to create a phone number list item in Persona.

Create String List Item

Tool to create a String List Item in Persona.

Create Webhook

Tool to create a new webhook in Persona.

Disable Webhook

Tool to disable a webhook in Persona.

Enable Webhook

Tool to enable a webhook in Persona.

Expire Inquiry Sessions

Tool to expire all inquiry sessions for specified inquiry IDs.

Import Email Address Lists

Tool to import email addresses into a list from a CSV file.

Import IP Address Lists

Tool to import IP address lists into Persona.

Import Name Lists

Tool to import name lists to Persona.

Import Phone Number Lists

Tool to import phone number lists into Persona.

List All Accounts

Tool to list all accounts in Persona.

List All API Logs

Tool to list all API logs in Persona.

List All Cases

Tool to list all cases in Persona.

List All Devices

Tool to list all devices filtered by inquiry session ID.

List all Events

Tool to list all events from Persona.

List all Importers

Tool to list all importers in Persona.

List All Inquiries

Tool to list all inquiries in Persona.

List All Inquiry Sessions

Tool to list all inquiry sessions in Persona.

List All Lists

Tool to list all lists in Persona.

List All Rate Limits

Tool to list all rate limits in Persona.

List All Reports

Tool to list all reports in Persona.

List All Transactions

Tool to list all transactions in Persona.

List All Webhooks

Tool to list all webhooks in Persona.

List all Workflow Runs

Tool to list all workflow runs in Persona.

Redact an Account

Tool to permanently redact an account in Persona.

Remove Account Tag

Tool to remove a tag from a Persona Account.

Retrieve a Country List Item

Tool to retrieve a country list item by ID in Persona.

Retrieve a Geolocation List Item

Tool to retrieve a geolocation list item from Persona.

Retrieve an Account

Tool to retrieve an account in Persona.

Retrieve a Name List Item

Tool to retrieve a Name List Item in Persona.

Retrieve an Event

Tool to retrieve an event in Persona.

Retrieve an Importer

Tool to retrieve a specific importer in Persona.

Retrieve IP Address List Item

Tool to retrieve an IP Address List Item in Persona.

Retrieve an API Log

Tool to retrieve an API log in Persona.

Retrieve a String List Item

Tool to retrieve a string list item by ID in Persona.

Retrieve a Webhook

Tool to retrieve a webhook by its ID.

Retrieve Browser Fingerprint List Item

Tool to retrieve a browser fingerprint list item in Persona.

Retrieve a Document

Tool to retrieve a document from Persona.

Retrieve Generic Document

Tool to retrieve a generic document in Persona.

Retrieve Email Address List Item

Tool to retrieve an Email Address List Item in Persona.

Retrieve Government ID Number List Item

Tool to retrieve a Government ID Number List Item in Persona.

Retrieve Phone Number List Item

Tool to retrieve a phone number list item in Persona.

Rotate Webhook Secret

Tool to rotate a webhook's secret in Persona.

Search Accounts

Tool to search accounts in Persona using flexible query criteria.

Search Cases

Tool to search cases in Persona using advanced query filters with boolean logic.

Set Tags on Account

Tool to set tags on a Persona Account.

Update an Account

Tool to update an account in Persona.

Update a Webhook

Tool to update a webhook in Persona.

Update Generic Document

Tool to update a generic document in Persona.

FRAMEWORKS

How to build Persona MCP Agent with another framework

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Persona MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Persona MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Persona MCP with Claude Code

Codex logo

Codex

Use Persona MCP with Codex

OpenClaw logo

OpenClaw

Use Persona MCP with OpenClaw

Hermes logo

Hermes

Use Persona MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Persona MCP with Atomic Agent

Google ADK logo

Google ADK

Use Persona MCP with Google ADK

LangChain logo

LangChain

Use Persona MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Persona MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Persona MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Persona MCP with LlamaIndex

CrewAI logo

CrewAI

Use Persona MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Persona MCP with Pydantic AI

AutoGen logo

AutoGen

Use Persona MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Persona MCP server, the agents and LLMs can only access a fixed set of Persona tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Persona and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Persona tools.

Yes, absolutely. You can configure which Persona scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Persona data and credentials are handled as safely as possible.

Start with Persona.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Persona tool your agent needs.Free to start.

Start building