> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Yuno with Claude and ChatGPT

> Connect your Yuno analytics data to Claude or ChatGPT and ask questions in plain language, backed by live SQL against your Yuno analytics warehouse.

Connect your Yuno analytics data to the AI assistant you already use. Ask questions about your payments data in plain language, like approval rates, decline reasons, or volumes by country or payment method, and get answers backed by live SQL queries against your Yuno analytics warehouse.

<Note>
  These connectors are analytics-only. They query your Yuno analytics warehouse and cannot create payments, issue refunds, or change your payment configuration. If you're a developer looking to build payment flows into your own agent, see [Building AI Integrations with Yuno's LLMs and MCP](/docs/ai-capabilities/building-ai-integrations-with-yunos-llms-and-mcp) and the [Remote Yuno MCP Server](/docs/ai-capabilities/remote-yuno-mcp-server) instead.
</Note>

## Setup

<Tabs>
  <Tab title="Claude">
    The fastest way to enable Yuno in Claude is through the connector directory.

    <Steps>
      <Step title="Open the Yuno connector listing">
        Open the [Yuno connector listing](https://claude.ai/directory/connectors/yuno) in the Claude directory.
      </Step>

      <Step title="Connect and authorize">
        Click **Connect** and sign in with your Yuno credentials to authorize access to your account's analytics data.
      </Step>

      <Step title="Enable Yuno in your chat">
        In any chat, open the search & tools menu and make sure **Yuno** is toggled on.
      </Step>

      <Step title="Ask your first question">
        Try: *"Describe the tables available in my Yuno analytics warehouse."*
      </Step>
    </Steps>

    <Note>
      Connectors added from the directory sync across claude.ai, Claude Desktop, and the mobile apps automatically, so you only need to connect once.
    </Note>
  </Tab>

  <Tab title="ChatGPT">
    Enable the Yuno app from the ChatGPT app directory.

    <Steps>
      <Step title="Open the Yuno app listing">
        Open the [Yuno app listing](https://chatgpt.com/plugins/plugin_asdk_app_6a3eabbf663c819186dda21300243f8e) in ChatGPT.
      </Step>

      <Step title="Add and link your account">
        Click **Add** (or **Connect**) and sign in with your Yuno credentials to link your account.
      </Step>

      <Step title="Invoke the app">
        In a new chat, invoke the app by name: type `@Yuno`, or just ask a payments-data question and ChatGPT will call the Yuno tools when relevant.
      </Step>

      <Step title="Ask your first question">
        Try: *"Using Yuno, what were my top decline reasons last week?"*
      </Step>
    </Steps>
  </Tab>
</Tabs>

## What you can do

Both connectors expose the same tools against your Yuno analytics warehouse. The assistant chooses the right tool automatically, so you never have to call them by name, but knowing what's available helps you know what to ask.

| Tool             | Type | Description                                                                                                                                              |
| ---------------- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `read_query`     | Read | Runs read-only SQL (`SELECT`, `WITH`, `SHOW`, `DESCRIBE`) against your analytics data. This powers most questions: metrics, breakdowns, trends, exports. |
| `table_overview` | Read | Describes a table's columns and types and shows a few sample rows, so the assistant learns your data's shape before querying it.                         |
| `analyze_query`  | Read | Returns the execution plan of a query without running it, so expensive queries can be sanity-checked first.                                              |

## Ask in plain language

* "What was my payment approval rate by payment method over the last 30 days?"
* "Show transaction volume by country for July, and flag any country that dropped more than 10% vs June."
* "What are my top 5 decline reasons this month, and which provider do they come from?"
* "Compare conversion between credit card and PIX in Brazil this quarter."
* "Describe the transactions table and show me a few sample rows."
* "Build me a weekly summary: volume, approval rate, refund rate, and average ticket."

## Read-only, scoped to your account

* **Scoped to your account**: The connector authenticates with your Yuno credentials and can only see the analytics data your account is entitled to.
* **Read-only by design**: The connectors only run read queries. Statements that modify data or schema are always rejected, so the assistant cannot change anything in your warehouse.
* **Query limits**: Very large result sets are truncated rather than streamed in full, and sessions are rate-limited to keep the warehouse healthy. For bulk exports, use the Yuno dashboard or API.

## Troubleshooting

**Claude says the Yuno connector is disconnected**

Go to Settings → Connectors, find Yuno, and click Reconnect, then re-authorize. If the connector doesn't appear in a chat, check that it's enabled in the chat's search & tools menu.

**ChatGPT doesn't call the Yuno app**

Invoke it explicitly by typing `@Yuno` at the start of your message, or mention "using Yuno" in the prompt. If it's still unavailable, remove and re-add the app from its directory listing.

**Queries fail with a "no database selected" error**

Ask the assistant to qualify tables with their database name (for example `analytics.transactions`) or to state which database to use. Asking "what tables are available?" first usually resolves this.

**Results look truncated**

That's expected for large outputs. Ask the assistant to aggregate (totals, top-N, grouped summaries) instead of listing raw rows, or narrow the date range.

## FAQ

<AccordionGroup>
  <Accordion title="Do the Claude and ChatGPT connectors do the same thing?">
    Yes. Both expose the same Yuno analytics tools. Pick the assistant your team already uses, or connect both; access and permissions are identical because they're governed by your Yuno credential, not by the assistant.
  </Accordion>

  <Accordion title="Can the connector move money or change my payment configuration?">
    No. These connectors are analytics-only: they query your data warehouse. They do not create payments, issue refunds, or touch your payment routing. For programmatic payment operations, see [Building AI Integrations with Yuno's LLMs and MCP](/docs/ai-capabilities/building-ai-integrations-with-yunos-llms-and-mcp) and the [Remote Yuno MCP Server](/docs/ai-capabilities/remote-yuno-mcp-server).
  </Accordion>

  <Accordion title="Is my data used to train AI models?">
    Your data is transferred to the assistant only within your own conversation, subject to Anthropic's or OpenAI's data policies for your plan. Consult your workspace's AI data-handling policy; enterprise plans of both providers exclude business data from training by default.
  </Accordion>

  <Accordion title="Can I connect Yuno to my own agent or IDE as a developer?">
    Yes. Yuno publishes an MCP server you can use from Cursor, Claude Code, or any MCP-compatible client. See the [Remote Yuno MCP Server](/docs/ai-capabilities/remote-yuno-mcp-server) and [Building AI Integrations with Yuno's LLMs and MCP](/docs/ai-capabilities/building-ai-integrations-with-yunos-llms-and-mcp).
  </Accordion>

  <Accordion title="Who do I contact if something's not working?">
    Reach out to your Yuno account manager or open a ticket through the Yuno dashboard. For developer issues with the MCP server, file them on [GitHub](https://github.com/yunopayments/yuno-mcp).
  </Accordion>
</AccordionGroup>