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

# Using Carat inside Claude (MCP connector)

> Create images and videos with Carat straight from a Claude chat. Covers the three connection steps, example requests, and how credits work.

Connect Carat to Claude as a **connector** and you can create images and videos with Carat without leaving your Claude chat. Claude handles the conversation and planning; Carat does the actual generating.

<Info>
  **What is MCP?** It is the standard way an AI tool like Claude calls another service's features directly. Carat connects to Claude through it. You only need to set up the connection once per account.
</Info>

## Where you can use it

Both **Claude chat and Claude Code** work with a single connector setup. ChatGPT support is in preparation.

## Connect in three steps

### 1. Copy the Carat connector address

```text theme={null}
https://mcp.carat.im/mcp
```

You only need to copy this once. You can also grab it with the copy button on [carat.im/mcp](https://carat.im/mcp).

### 2. Paste it into Claude's add-connector dialog

In Claude, go to \[Customize(사용자 지정)] → \[Connectors(커넥터)] → \[Add(추가)] (or open [claude.ai/settings/connectors](https://claude.ai/settings/connectors) directly). When the \[Add custom connector(커스텀 커넥터 추가)] dialog opens, fill it in as follows.

| Field                                   | Value                      |
| :-------------------------------------- | :------------------------- |
| \[Name(이름)]                             | `Carat`                    |
| \[Remote MCP server URL(원격 MCP 서버 URL)] | `https://mcp.carat.im/mcp` |

Naming it `Carat` makes it easy to spot in your connector list during a chat.

### 3. Leave the advanced settings as "detected" and save

Advanced settings such as \[Authentication(인증)] and \[OAuth Client(OAuth 클라이언트)] are picked up from the Carat server automatically, so **save them as-is while they show "detected"**. You do not need to fill anything in. After saving, log in with your Carat account when the Carat login window appears and allow access.

<Note>
  You need to **open a new chat** after connecting before Carat's tools become available. Check that Carat is switched on under \[Connectors(커넥터)] in the message box. If the tools do not appear, see [Carat's tools do not show up in Claude](/docs/en/troubleshooting/mcp/tools-not-showing).
</Note>

## How to ask in Claude

Once connected, just ask in plain language. Claude organizes the request, passes it to Carat, and Carat's result comes back into the chat as a card.

<AccordionGroup>
  <Accordion title="Marketing video">
    ```text theme={null}
    Make a UGC-style ad for Instagram Reels with this serum. 15 seconds, honest-review tone.
    ```

    Carat sets the concept and script first, locks the product details, then continues into an edited cut with subtitles.
  </Accordion>

  <Accordion title="Promotional images">
    ```text theme={null}
    Make launch banners for the FW lineup. I need both a horizontal website version and a square Instagram version.
    ```

    Carat sets the key visual first, then opens up different copy space per aspect ratio so the set stays consistent.
  </Accordion>

  <Accordion title="Photo editing">
    ```text theme={null}
    Remove the background from this shoe photo and give me a white-background studio cut and an outdoor on-foot cut.
    ```

    Carat cleans up the background and changes only the lighting, keeping the shape and material of the original.
  </Accordion>

  <Accordion title="Finding prompts">
    ```text theme={null}
    What prompts are there for film-camera style portraits?
    ```

    Carat finds matching items in the Carat prompt gallery, and you can pick one and apply it to your own photo right away.
  </Accordion>

  <Accordion title="Scheduled generation">
    ```text theme={null}
    Every Monday morning, make Instagram card news with that week's three new products.
    ```

    Register it as a recurring schedule and Carat generates it ahead of time and lets you know.
  </Accordion>
</AccordionGroup>

## Available models

You can specify Carat's latest image and video models directly from Claude.

* **Image:** Nanobanana Pro, ChatGPT Image 2.0, Midjourney, Seedream 5.0, Grok Imagine 2.0, Gemini Omni Flash
* **Video:** Seedance 2.5, Kling O3

If you do not specify a model, Carat picks one that suits your request. To use a specific model, include its name in your request. Supported models keep expanding — see [Model selection](/docs/en/how-to-use/model-selection) for the current list.

## Credits and plan requirements

| Item                | Rule                                                                                                                                                                                                                                   |
| :------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Plan required       | Free and paid plans can currently both use the same MCP tools. Which apps you can use does depend on your account permissions → [Can I use MCP on the Free plan?](/docs/en/troubleshooting/mcp/free-plan-availability)                      |
| Claude conversation | Carat does not charge credits for the conversation itself in your Claude chat                                                                                                                                                          |
| Carat generation    | Carat credits are used when you create images, videos, and so on. Steps such as planning your request or analyzing a file or image can also use credits                                                                                |
| Unlimited benefits  | **Not applied.** Unlimited benefits apply only to the AI agent and the \[Generator(생성기)] in the Carat app and website → [Unlimited benefits do not apply to MCP generations](/docs/en/troubleshooting/usage-plan/mcp-unlimited-not-applied) |

## Where your results go

You can download results straight from the result card, and **image and video results that completed normally** can be found again in the \[Library(라이브러리)] on the same Carat account. Click \[Add to input(입력창에 추가)] in the library to keep working on it in the Carat agent (your Claude conversation itself does not carry over). See [Where are results made in Claude saved?](/docs/en/troubleshooting/mcp/where-are-results-saved) for details.

## Related articles

<CardGroup cols={2}>
  <Card title="Carat's tools do not show up in Claude" icon="plug-circle-exclamation" href="/docs/en/troubleshooting/mcp/tools-not-showing">
    Checking the connector, reconnecting, and tool permissions
  </Card>

  <Card title="Can I connect on my phone?" icon="mobile-screen" href="/docs/en/troubleshooting/mcp/mobile-connection">
    Adding the connector from a mobile browser
  </Card>

  <Card title="Uploading a reference file" icon="paperclip" href="/docs/en/troubleshooting/mcp/attach-reference-file">
    Getting your own photo to Carat as a reference
  </Card>

  <Card title="Can I use MCP on the Free plan?" icon="circle-question" href="/docs/en/troubleshooting/mcp/free-plan-availability">
    Tools, credits, and permission conditions by plan
  </Card>

  <Card title="Unlimited benefits do not apply to MCP" icon="infinity" href="/docs/en/troubleshooting/usage-plan/mcp-unlimited-not-applied">
    How credits are charged for MCP generations
  </Card>
</CardGroup>