Skip to main content

How do I connect Zoya to Claude?

Add Zoya as a custom connector in Claude on the web or desktop, use it on mobile, or add it to Claude Code.

Add Zoya as a custom connector in Claude on the web or the desktop app, then sign in with your Zoya account. Once it's added, Zoya is also available in the Claude mobile app. You'll need an active Zoya Pro subscription to use it. If your assistant says a Zoya tool requires Zoya Pro, see Why does my AI assistant say a Zoya tool requires Zoya Pro?

Claude on the web or desktop

  1. In Claude, go to Customize > Connectors

  2. Click + Add, then Add custom connector

  3. Enter Zoya as the name and https://mcp.zoya.finance/mcp as the server URL, then click Continue

  4. Click Continue on the authentication settings Claude detects

  5. Under Authentication, choose Sign in now, leave the other options as they are, and click Add

  6. On Zoya's sign-in page, choose Zoya app account and sign in with the same login you use in the Zoya app

  7. Review what Claude will be able to do and click Allow access

On Claude's Free plan, you can add one custom connector.

Using Zoya in a chat

Click the + button at the lower left of the chat, hover over Connectors, and make sure Zoya is turned on. Then ask a question, such as "Why is Microsoft Questionable under AAOIFI?"

Claude on your phone

Add Zoya on the web or desktop first, using the steps above. It will be available in the Claude app for iOS or Android the next time you sign in there.

Claude Team and Enterprise

An organization owner adds the connector first. They go to Organization settings > Connectors, click Add, hover over Custom, select Web, and enter the name and server URL above.

Each member then goes to Customize > Connectors, finds Zoya, and clicks Connect to sign in with their own Zoya account.

Claude Code

  1. In your terminal, run this command:

    claude mcp add --transport http zoya https://mcp.zoya.finance/mcp

  2. Start Claude Code and type /mcp

  3. Choose zoya and follow the steps in your browser to sign in and allow access

This adds Zoya to your current project. To use it in every project, add --scope user to the command.

Staying signed in

Expect to sign in to Zoya again about once a week. In Claude, go to Customize > Connectors and connect Zoya again. In Claude Code, run /mcp again.

Troubleshooting

  • Check that Zoya is turned on in the chat's Connectors menu

  • If Zoya shows an error, go to Customize > Connectors, disconnect Zoya, and connect it again. This fixes most problems. In Claude Code, run /mcp, choose zoya, and sign in again

  • If Claude answers without using Zoya, ask it to, for example "Use Zoya to check Apple"

  • Still stuck? Contact Zoya support and tell us which version of Claude you're using

To see what you can ask, see What is the Zoya MCP?

Related Articles
Did this answer your question?