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

# Connect from Muse

> Ask Muse to add the Pictory MCP server as a custom connector, sign in once with your Pictory account, and start creating videos in your chats.

This page adds the Pictory MCP server to Muse as a custom connector. You do this once.
You do not fill in a form. You ask Muse in a chat, and it sets up the connector for you.
After you sign in, Pictory is connected, and you can use it in your chats.

## Before You Start

Use the Pictory account where you want your videos and projects to be saved.

**You do not need an API key or an API subscription.** You sign in with your Pictory account.

* **A Pictory account.** You sign in with it when you connect Pictory.
* **An active subscription or eligible Free Trial.** Available video minutes, voice-over
  usage, and AI Credits depend on the account or team you connect.
* **A Muse account that can create custom connectors.** Muse is available only in some
  countries, including the US, Canada, Japan, and Singapore.

## Add the Pictory Connector

**1. Ask Muse to add Pictory**

Open a Muse chat, on the web at [muse.ai](https://muse.ai) or in the Muse app. Send this
message:

```text theme={null}
Create a custom connector for the MCP server https://mcp.pictory.ai/mcp
```

Muse checks the Pictory MCP server and prepares the connection. Pictory uses sign-in with
your Pictory account, so Muse does not need an API key.

![A Muse chat with the message Create a custom connector for the MCP server https://mcp.pictory.ai/mcp, and a reply saying that Pictory uses sign-in with a Pictory account and that a secure sign-in link comes next](https://mintcdn.com/pictory/rq8a8JSlPTfTNpMj/images/muse-mcp/ask-muse-to-connect.png?fit=max\&auto=format\&n=rq8a8JSlPTfTNpMj\&q=85\&s=b7405d81096f968f447814ce6f66bade)

Ask Muse to create a custom connector for the Pictory MCP server.

**2. Open the secure sign-in link**

Muse sends you a secure link to connect Pictory. Select **Add a custom connector**.

Muse also lists the access it asks for. The last two may appear in a shorter form, such as
`pictoryapis.read`.

| Access | What it allows |
| - | - |
| `openid` | Confirms who you are when you sign in. |
| `email` | Shares the email address of your Pictory account. |
| `pictoryapis/pictoryapis.read` | Lets Muse read your account details, such as your voices, brand kits, and remaining usage. |
| `pictoryapis/pictoryapis.write` | Lets Muse create videos and projects in your account. |

![A Muse reply asking you to sign in with your Pictory account, with the Add a custom connector button and the access requested: openid, email, pictoryapis.read, and pictoryapis.write](https://mintcdn.com/pictory/rq8a8JSlPTfTNpMj/images/muse-mcp/add-custom-connector.png?fit=max\&auto=format\&n=rq8a8JSlPTfTNpMj\&q=85\&s=e08baa2f2f135505565ed964f807ef7d)

Select Add a custom connector to open the Pictory sign-in page.

> [!WARNING]
>
> Do not paste a password, API key, or token into the chat. Sign in only on the Pictory
> sign-in page that the link opens.

**3. Sign in to Pictory**

Choose one way to sign in:

* Select **Continue with Google**.
* Enter your Pictory email and password, then select **Sign in**.

When sign-in succeeds, go back to your Muse chat. Muse finishes setting up the connector
and checks your Pictory account.

![The Pictory sign-in page with the Continue with Google button and the email and password fields](https://mintcdn.com/pictory/l2SkllNpxXDkx6L0/images/chatgpt-mcp/pictory-sign-in.png?fit=max\&auto=format\&n=l2SkllNpxXDkx6L0\&q=85\&s=92b93a1a4f1737f7379f92d2a641b249)

Sign in with Google, or with your Pictory email and password.

**4. Check that Pictory is connected**

Muse tells you when Pictory is connected. It also checks which type of video your account
supports, so you do not need to choose a video type yourself.

To check the connection at any time, ask Muse:

> How much quota do I have left?

Muse checks your Pictory account and tells you your remaining usage.

![A Muse chat confirming that Pictory is connected and that the account supports Motion Graphics videos, followed by the question How much quota do I have left and Muse's reply](https://mintcdn.com/pictory/rq8a8JSlPTfTNpMj/images/muse-mcp/pictory-connected.png?fit=max\&auto=format\&n=rq8a8JSlPTfTNpMj\&q=85\&s=cab88f9f53fc97f500ad9df1d8a10da1)

Muse confirms that Pictory is connected and checks your quota.

> [!NOTE]
>
> **Which account is billed.** Usage comes from the Pictory account or team you signed in with.
> Your plan sets the available video minutes, voice-over usage, and AI Credits.

You are ready to create videos. See [Use Pictory in Muse](https://docs.pictory.ai/muse/use-pictory-in-muse.md).

## Managing the Connector

You manage the Pictory connector by asking Muse in a chat. Disconnecting Pictory does not
delete videos or projects from your Pictory account.

### Use a Different Pictory Account

1. Ask Muse to disconnect Pictory.
2. Add Pictory again by following [Add the Pictory Connector](#add-the-pictory-connector).
3. Sign in with the other Pictory account.

### Get New Features

Pictory adds new features to the MCP server from time to time. If a new feature does not
appear in Muse:

1. Ask Muse to disconnect Pictory.
2. Add Pictory again by following [Add the Pictory Connector](#add-the-pictory-connector).
3. Sign in with the same Pictory account.
4. Start a new chat.

Your existing Pictory projects stay in your account.
Reconnecting does not move a Pictory 2.0 account to Pictory 3.0.

## Troubleshooting

> [accordion] Muse Says the Provider Rejected the Registration
>
> **Cause:** Pictory did not accept the connection request from Muse. This is usually
> temporary.
>
> **Resolution:**
>
> 1. Wait a moment, then ask Muse to try again.
> 2. If it still happens, contact [Pictory support](mailto:support@pictory.ai). Say that you
>    are connecting the Pictory MCP server in Muse.

> [accordion] Muse Asks for an API Key
>
> **Cause:** Muse did not detect that Pictory uses sign-in with your Pictory account.
>
> **Resolution:**
>
> 1. Do not send an API key. The Pictory MCP server does not need an API key or an API
>    subscription.
> 2. Ask Muse to connect the Pictory MCP server with OAuth sign-in instead. OAuth means you
>    sign in with your Pictory account on the Pictory sign-in page.
> 3. Sign in on the Pictory sign-in page that the link opens.
>
> An API key is only for the [Pictory REST API](https://docs.pictory.ai/api-reference.md). That is a separate way to use
> Pictory, for developers who build applications.

> [accordion] I Signed In with the Wrong Pictory Account
>
> **Cause:** The sign-in used a different Pictory account from the one where you want your
> videos and projects to be saved.
>
> **Resolution:** Follow [Use a Different Pictory Account](#use-a-different-pictory-account),
> and sign in with the account you want to use.

> [accordion] Every Request Fails After Signing In
>
> **Cause:** The sign-in has expired, or the connected account does not have access to the
> requested feature or enough remaining usage.
>
> **Resolution:**
>
> 1. Check your plan and remaining usage at [app.pictory.ai](https://app.pictory.ai).
> 2. Ask Muse to disconnect Pictory, then add it again and sign in.

## Next Steps

> [card] [Use Pictory in Muse](https://docs.pictory.ai/muse/use-pictory-in-muse.md)
>
> Ask for what you want in a chat and see what you get back

> [card] [Pictory MCP Server](https://docs.pictory.ai/claude-mcp/overview.md)
>
> Every tool, video type, and option available through your connection


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.