> For the complete documentation index, see [llms.txt](https://docs.askyazi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.askyazi.com/integrations-and-api/connect-claude-or-chatgpt.md).

# Connect Claude or ChatGPT

Connect Claude or ChatGPT to your Yazi organisation and ask questions about your studies and results in plain English.

The Yazi connector lets your own AI assistant (Claude, ChatGPT or Codex) read your Yazi studies and results, so you can ask questions like "how is completion going on the coffee study?" or "of the people who said they switched banks, what reasons did they give?". It uses MCP (Model Context Protocol), the standard way AI assistants connect to outside tools. You set it up from **Settings > Integrations > Connectors**.

{% hint style="info" %}
**In short:**

* Server address: `https://mcp.askyazi.co/mcp`. It works with claude.ai, Claude Desktop, Claude Code and ChatGPT.
* It is read only unless you grant more. It can never delete anything, launch a study or see another organisation.
* You choose what it may do when you sign in, and you can revoke access at any time.
  {% endhint %}

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2Fd08oY2LzqZA7ln6Bs0sO%2Ffs-settings-integrations.webp?alt=media&amp;token=d1c43bc0-8ddf-4ffa-8fb7-72ba97f3f0ac" alt="Settings > Integrations: connect Claude or ChatGPT with the MCP server URL, and the Google Sheets and Microsoft Excel connections below"><figcaption></figcaption></figure>

## Before you start

* You need a Yazi login with access to the organisation whose data you want to query. If you cannot see the **Connectors** card, ask an admin in your organisation.
* You need an account with Claude or ChatGPT that allows custom connectors or apps. Some company plans let administrators restrict this.
* If your company network filters traffic, `mcp.askyazi.co` may need to be allow-listed. See [Network allow-listing](https://docs.askyazi.com/set-up-whatsapp/network-allow-listing-for-corporate-it.md).

## Set it up

{% tabs %}
{% tab title="claude.ai" %}

1. In Yazi, go to **Settings > Integrations** and click **Open in Claude**. (Or, in Claude, go to **Customize**, then **Connectors**, then **Add**, then **Add custom connector**.)
2. Name it "Yazi", paste `https://mcp.askyazi.co/mcp`, click **Continue**, then **Add**.
3. Click **Connect**, then **Allow access** on the Yazi page that opens. Sign in to Yazi if asked, and choose what the connector may do.
4. Optional but recommended: in the connector's **Tool permissions**, set the read-only tools to **Always allow**, so Claude does not ask before every lookup.
   {% endtab %}

{% tab title="Claude Desktop" %}

1. Follow the steps on the **Claude Desktop** tab in **Settings > Integrations**. In Claude Desktop, add a custom connector.
2. Name it "Yazi" and paste `https://mcp.askyazi.co/mcp`.
3. Click **Connect**, sign in to Yazi in the browser window that opens, choose what the connector may do, and click **Allow access**.
4. Optional: set the read-only tools to **Always allow**.
   {% endtab %}

{% tab title="Claude Code" %}

1. In a terminal, run:

   ```bash
   claude mcp add --transport http yazi https://mcp.askyazi.co/mcp
   ```

   Add `--scope user` to make it available in all your projects.
2. Start Claude Code and run `/mcp`. Select **yazi** and follow the browser sign-in. Choose what the connector may do and click **Allow access**.
3. Check it is connected with `claude mcp list`.

The **Claude Code** tab in **Settings > Integrations** shows the same command, ready to copy.
{% endtab %}

{% tab title="ChatGPT" %}

1. Follow the steps on the **ChatGPT** tab in **Settings > Integrations**. In ChatGPT's settings, add a custom app (connector).
2. Enter the Yazi server address `https://mcp.askyazi.co/mcp`.
3. Sign in to Yazi when asked and choose what the app may do. The sign-in page names the app you are connecting.

Whether you can add custom apps depends on your ChatGPT plan and your workspace settings. Codex connects the same way.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2Fv1k2rt7aL1RwYr68vVax%2Fchatgpt-connector.webp?alt=media&amp;token=a695083f-3d85-48ee-9cd7-2c1874d1599d" alt="The Connectors card with the ChatGPT set-up steps"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

## Permissions

When you sign in, you choose what the assistant may do. Each permission is separate and can be revoked from **Settings > Integrations > Connectors > Manage connections**.

| Permission                    | What it allows                                                                                                     | Default   |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------ | --------- |
| Read your research            | List studies, read questions, results, cross-tabs, participants (masked) and transcripts.                          | Always on |
| Make changes to studies       | Pause, resume or close a study, rename it, and add or edit questions on a study that is still in Draft or Testing. | Off       |
| See participant phone numbers | Show full phone numbers instead of masked ones, and stop redacting contact details from answers.                   | Off       |
| Include demographics          | Join de-identified profile data (such as age band, gender and region) to answers. Never names or contact details.  | Off       |

## What you can ask

* "Which of my studies are live, and how is completion going?"
* "Show me the results for Q4 in the brand study, as percentages."
* "Of the people who chose 'Too expensive' in Q3, what did they say in Q7?"
* "Cross-tab Q2 by Q5 and tell me if the difference is significant."
* "Find what participants said about delivery times across all my studies."
* "Read the transcript for participant p\_12ab and summarise it."
* "Export the full results of the wave 2 study as a CSV."

## What it can do

| Area                   | What the connector does                                                                                                                                                   |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Studies                | Lists studies and reads each study's questions, status and funnel numbers.                                                                                                |
| Results                | Gives per-question results with the base stated, and respondent-level answers (up to 1,000 rows per request in long format, 200 in wide format, with paging).             |
| Cross-tabs             | Cross-tabulates two closed questions as counts, row % or column %, with a chi-square test. Cells with fewer than 5 people are hidden so individuals cannot be identified. |
| Search                 | Searches open answers, messages and voice note transcripts across your organisation or within one study.                                                                  |
| Transcripts            | Reads one participant's conversation (up to 300 messages, each up to 2,000 characters).                                                                                   |
| Export                 | Queues a background CSV export of one study (up to 50,000 rows) and returns a download link when it is ready.                                                             |
| Changes (if permitted) | Pauses, resumes or closes a study; renames it or updates its description; adds or edits questions while the study is in Draft or Testing.                                 |

## What it cannot do

* Delete anything.
* Launch a study (move it from Draft to Live), or set a study back to Draft.
* Change a study's type, channel or schedule.
* Change questions once a study is Live.
* Send broadcasts or message participants.
* See any other organisation's data.
* Export more than one study at a time, or more than 50,000 rows in one export.

## How your data is protected

* **Pseudonymous participant IDs.** Each participant is a stable code (for example `p_...`), the same across your organisation's studies, that cannot be reversed into a phone number or name.
* **Masked phone numbers.** Only the country code and last three digits show, unless you granted the phone number permission.
* **Contact details scrubbed.** Phone numbers, emails and ID numbers typed into answers are redacted, unless you granted the phone number permission.
* **No names.** Participant names are never returned.
* **Participant text is treated as data.** Answers are labelled as participant content, so text a participant typed cannot steer the assistant.
* **Audited and rate limited.** Every call is recorded in Yazi's audit trail, and use is rate limited (for example, two export jobs at a time per organisation).
* **Organisation scoped.** Every request is limited to the organisation you connected.

Your AI provider processes what the connector returns under your own agreement with that provider. Check your company's AI policy before connecting. See [How Yazi uses AI](https://docs.askyazi.com/security-and-privacy/ai-and-your-data.md).

## Limits and things to know

* **Answers depend on the assistant.** The connector returns accurate data, but the assistant writes the summary. Check any number that matters against Yazi.
* **Rate limits.** Large requests are paged, and exports are limited to a few per minute.
* **Open text is truncated** at 2,000 characters per answer.
* **Revoking.** Removing access in **Manage connections** stops the connector working. You can also remove the connector in Claude or ChatGPT.

## Related

* [Ask Yazi](https://docs.askyazi.com/build-a-study/ask-yazi.md) (the assistant inside the Yazi app)
* [How Yazi uses AI](https://docs.askyazi.com/security-and-privacy/ai-and-your-data.md)
* [Analysis limits](https://docs.askyazi.com/results-and-reporting/analysis-limits.md)
* [Exports](https://docs.askyazi.com/results-and-reporting/exports.md)
