> For the complete documentation index, see [llms.txt](https://help.parta.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.parta.io/mcp/connect-parta.io-mcp-to-claude.md).

# Connect Parta.io MCP to Claude

Use Parta.io MCP to allow Claude to read and edit content in Parta.io directly from chat.

{% hint style="warning" %}
We renamed the Parta MCP server addresses: **v1beta** is now **v1**. If your connector address ends with v1beta, remove the connector. Add it again with the new address from step 1. Then connect your account (step 2).
{% endhint %}

{% hint style="info" %}
Parta MCP works over the standard MCP protocol. Parta does not store or process incoming chat data.
{% endhint %}

### Step 1. Organization Setup

{% hint style="warning" %}

* To connect Parta.io MCP to your **organization** in Claude, follow the step 1 instructions as an **organization administrator or owner**.\
  \
  Everyone in your organization will be able to use it after finishing [activation](#step-2.-activate-the-connector).
* To connect Parta.io MCP to your **personal account** in Claude, follow the step 1 - 3 instructions as an **account owner**.
  {% endhint %}

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FGn3wcmXwrlLOd7rGTrwS%2FMCP.01.png?alt=media&amp;token=326177bd-596d-4b31-943f-061e862f1094" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Open [Claude](https://support.claude.com/en/articles/8114491-get-started-with-claude) and go to **Customize**.
{% endstep %}

{% step %}
Go to **Connectors.**
{% endstep %}

{% step %}
Click **+ Add connector**.

A pop-up window will appear.
{% endstep %}

{% step %}
Click **Add Custom Connector**.

A pop-up window will appear.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FyldgaQRXRKSgWbSdAURR%2F01-add-custom-connector-plain_1.png?alt=media&amp;token=59c6063d-dcab-4aa4-962a-33042e6086fd" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Enter a connector name in the **Name** field.

**e.g.** `Parta MCP`
{% endstep %}

{% step %}
Enter the connector server address in the **Remote MCP server URL** field.

* For the **Parta MCP Instructional Designer** connector:\
  `https://mcp.parta.io/inst-design/v1`
* For the **Parta MCP Block Builder** connecto&#x72;**:**\
  `https://mcp.parta.io/block-builder/v1`
  {% endstep %}

{% step %}
Click the **Continue** button.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Add each connector separately.
{% endhint %}

### Step 2. Personal Setup

{% hint style="warning" %}
Each user must complete these steps individually, including users granted access through their organization.
{% endhint %}

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2Fmq0S2cSBTJwP89YV9Dla%2FMCP.03.png?alt=media&amp;token=7633f30e-1d55-4931-b755-8499abb3d8e3" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
Open [Claude](https://support.claude.com/en/articles/8114491-get-started-with-claude) and go to **Customize**.
{% endstep %}

{% step %}
Go to **Connectors.**
{% endstep %}

{% step %}
Select **Parta MCP** (or the custom name your admin set) at the **Connectors** list.
{% endstep %}

{% step %}
Click the **Connect** button.

A new Parta.io window will appear.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FkFNg8Rotrm32vDk3glwk%2FMCP.04.png?alt=media&amp;token=e629ab06-fbdf-491a-9304-760c9c1342d6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **Allow access** button.

A new Claude window will appear.

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2FtukwBuEUKcJsK5T5YGbQ%2FMCP.05.png?alt=media&amp;token=9901ecf1-ad98-4568-aa12-e19f3f503548" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Select an **Always allow** option from every available drop-down menu at the **Tool permissions** list.

Otherwise, the chat will prompt you for permission before every method execution.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
Parta.io MCP is connected to your account.
{% endhint %}

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2F2dAXL8FKj0wCp7meLVu9%2F02-connectors-list-blurred-original-names-plain_1.png?alt=media&amp;token=5725400f-fe6a-46ad-a64e-4e07cd84e520" alt=""><figcaption></figcaption></figure>

### Step 3. Test the Connection

<figure><img src="https://3560131808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKhlOpFC8JmF8TcxylWx%2Fuploads%2F3piiDHuLNgsnEDfiwXQa%2FMCP.06.png?alt=media&amp;token=9edfd02c-1f47-49e1-859b-389693eee231" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}
[Open a new chat at Claude](https://support.claude.com/en/articles/8114491-get-started-with-claude) and type the following text:

```
Give me a list of the available organizations in Parta
```

{% endstep %}

{% step %}
Make sure Claude returns a list.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
The setup is complete.
{% endhint %}

### Troubleshooting

Have more questions? You might find answers below:

<details>

<summary>I am not redirected back to Claude after logging in</summary>

1. Close the browser tab;
2. Go back to **Customize → Connectors;**
3. Click **Connect** again for **Parta MCP**.

</details>

<details>

<summary>I see an <strong><code>Unauthorized</code> error</strong> in chat</summary>

Your session may have expired.

1. Go to **Customize → Connectors;**
2. Disconnect and reconnect **Parta MCP**.

</details>

<details>

<summary>Claude Web fails working with images</summary>

Claude Web can fail on image-based tasks because of file storage limits;

* Use **Claude Desktop** for image-heavy workflows.

</details>

<details>

<summary>I get an error saying the monthly limit is reached</summary>

Each workspace has a monthly limit of **500 Parta MCP calls** during the trial period. Calls from both connectors, Parta MCP Instructional Designer and Parta MCP Block Builder, count toward this limit. The limit resets at the start of each calendar month.

The limit resets at the start of each calendar month. To raise your limit, contact support at <support@parta.io>.

</details>

<details>

<summary>Parta MCP worked before, but now Claude can't use it</summary>

We renamed the server address from **…/v1beta** to **…/v1**. Check the connector address in **Customize → Connectors**. If it ends with v1beta, remove the connector. Add it again with the new address from step 1. Then click **Connect** and sign in to Parta.

</details>

{% hint style="info" %}
If you are connecting to a test environment, use the invite link and server address provided by your team.
{% endhint %}
