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

# Ryft MCP

> Enrich AI agents with lakehouse context using the Ryft MCP server. Supports any agent framework.

<Note>Ryft MCP is currently in **Private Preview**. To get early access, contact your Ryft representative.</Note>

Ryft MCP is a [Model Context Protocol](https://modelcontextprotocol.io/) server that enriches your AI agents with full lakehouse context, including table metadata, query history, and domain knowledge - so they can write accurate queries and answer business questions without guessing.

## Prerequisites

* One of the supported AI tools: [Claude](https://claude.ai), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), or [Cursor](https://www.cursor.com/)

## Setup

<Tabs>
  <Tab title="Cursor">
    **1. Add MCP configuration**

    <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=ryft&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBwLnJ5ZnQuaW8vbWNwIn0=">
      <img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add Ryft MCP to Cursor" style={{height: '40px', width: 'auto'}} noZoom />
    </a>

    **2. Connect**

    Click **Install** in the prompt that appears, then click **Connect**. A browser window will open for you to log in with your Ryft credentials. After authenticating, you can close the browser tab and return to Cursor.

    <Accordion title="Manual setup">
      Add the following to `.cursor/mcp.json` in your project root (or `~/.cursor/mcp.json` for global access):

      ```json theme={null}
      {
        "mcpServers": {
          "ryft": {
            "type": "http",
            "url": "https://app.ryft.io/mcp"
          }
        }
      }
      ```

      Then open Cursor Settings (`Cmd/Ctrl + Shift + J`) > **Tools & MCP** > find **Ryft** > **Enable** > **Connect**. A browser window will open for you to log in with your Ryft credentials.
    </Accordion>
  </Tab>

  <Tab title="Claude Code">
    **1. Add MCP server**

    Run the following command in your terminal:

    ```bash theme={null}
    claude mcp add --transport http ryft https://app.ryft.io/mcp
    ```

    **2. Connect and authenticate**

    In Claude Code, run `/mcp` to load the server. Select Ryft and choose **Authenticate**. A browser window will open for you to log in with your Ryft credentials.
  </Tab>

  <Tab title="Claude">
    <Note>Custom connectors are available on Claude Pro, Max, Team, and Enterprise plans.</Note>

    **1. Add a custom connector**

    Go to **Settings** > **Connectors** > **Add custom connector** and enter the following:

    <Frame>
      <img src="https://mintcdn.com/ryft/0S4ccLh3rdy3KeZW/images/claude_add_connector.png?fit=max&auto=format&n=0S4ccLh3rdy3KeZW&q=85&s=9ea6897a5c8b4d5ad9d6598c032a25a5" alt="Add custom connector dialog in Claude" width="1574" height="943" data-path="images/claude_add_connector.png" />
    </Frame>

    | Field                     | Value                     |
    | ------------------------- | ------------------------- |
    | **Name**                  | `Ryft`                    |
    | **Remote MCP server URL** | `https://app.ryft.io/mcp` |

    Click **Add** to save the connector.

    **2. Authenticate**

    A browser window will open for you to log in with your Ryft credentials. Once authenticated, the Ryft connector will be available in your conversations. You can close the browser tab and return to Claude.

    **3. Enable in conversations**

    In a new conversation, click the **+** button at the bottom of the chat, then **Connectors**, and toggle **Ryft** on.
  </Tab>
</Tabs>

## Verify

To confirm everything is working, ask your AI tool any question about your lakehouse, for example:

> "Search for tables related to orders"

If the connection is set up correctly, the assistant will use the `search_tables` tool and return results from your lakehouse.

## Troubleshooting

<Accordion title="Authentication expired or failed">
  Your AI tool will prompt you to re-authenticate via your browser. Follow the prompts to log in again.
</Accordion>

<Accordion title="MCP server not connecting">
  * Verify your network can reach `app.ryft.io`. Check if your organization requires a VPN.
  * For Claude: go to Settings > Connectors and check that Ryft is enabled
  * For Claude Code: run `/mcp` to check server status
  * For Cursor: open Cursor Settings (`Cmd/Ctrl + Shift + J`) > Tools & MCP to check server status
</Accordion>

<Accordion title="Tools not appearing">
  Restart your AI tool after adding the MCP configuration. For Claude Code, run `/mcp` to reconnect.
</Accordion>