# Integrating the Patchworks documentation MCP server with Claude

## Introduction

Integrating the Patchworks documentation MCP server with Claude (via your client or Claude Code) is very straightforward. Both approaches are detailed below:

* [Integrating with your Claude client](#integrating-with-your-claude-client)
* [Integrating with Claude Code](#integrating-with-claude-code)

## Need to know

* MCP (Model Context Protocol) servers are a feature that requires a Claude Pro subscription.
* The URL for the Patchworks product documentation MCP server is: `https://doc.wearepatchworks.com/product-documentation/~gitbook/mcp`

## Integrating with your Claude client

{% stepper %}
{% step %}
**Access Claude connector settings**

Open your Claude client and navigate to `settings` ➤ `connectors`. For example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FT0SPVYCio5iGzwXeCN8k%2Fadd%20docs%20mcp%201.png?alt=media&#x26;token=994c9c0a-f0f6-4197-bb9f-0538ea51a249" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Add a custom connector**

Select the `add custom connector` button (you may need to scroll down to find it):

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FnfJlGGX1xael3jpUH2xs%2Fadd%20docs%20mcp%202.png?alt=media&#x26;token=9032a1fe-344c-44c7-b6c4-aee4277d64d2" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Configure your connector**

To configure a Claude connector, you must provide a name and a `remote MCP server URL`:&#x20;

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FaEaEROhO41efmhzPyVBo%2Fadd%20docs%20mcp%204a.png?alt=media&#x26;token=d34e66e2-ce98-4c1a-897a-d3e0c1300dd4" alt=""><figcaption></figcaption></figure></div>

Complete these details using the guidance below.

<table><thead><tr><th width="223.1015625">Field</th><th>Summary</th></tr></thead><tbody><tr><td>Name</td><td>Your preferred name for this connector (for example, <code>Patchworks Docs</code>)</td></tr><tr><td>Remote MCP server URL</td><td>Always set to: <br><code>https://doc.wearepatchworks.com/product-documentation/~gitbook/mcp</code></td></tr></tbody></table>

For example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FQHElsK9nuFNG2aF6BfsQ%2Fadd%20docs%20mcp%203.png?alt=media&#x26;token=c1697053-8aa3-4a7d-ad11-1d07f0770362" alt=""><figcaption></figcaption></figure></div>

Having entered details, click the `add` button to confirm details and add this connector to the list.
{% endstep %}

{% step %}
**Review/update configuration options**

Click the `configure` button associated with your new connector. For example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FYp47GFE6FIdSYSZ7iHzV%2Fadd%20docs%20mcp%204.png?alt=media&#x26;token=8c4419ce-f4eb-4494-8f8b-443183304404" alt=""><figcaption></figcaption></figure></div>

Choose how you want Claude to behave when attempting to use this connector. For example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FoDpgk0dd0SOyJ513rZiC%2Fadd%20docs%20mcp%205.png?alt=media&#x26;token=b1bf9f1d-da2b-48b7-9ec9-66699257bd1b" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
In our example, the always allow option is selected, so requests will be seamless. If preferreed, you can select an alternative option here.
{% endhint %}
{% endstep %}

{% step %}
**Test the MCP connection**

Start a new Claude chat and ask a Patchworks-related question. For example, *What are the different shapes that I can add to a Patchworks process flow?* The response should indicate that the connector was used - for example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F2dqSrmCYPuQVFEBKgOem%2Fadd%20docs%20mcp%206.png?alt=media&#x26;token=59771a2a-c6f3-49a1-8fd7-f80a2020a27e" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## Integrating with Claude Code

To add the Patchworks documentation MCP server to Claude Code, launch Claude Code and enter the following command:

{% code overflow="wrap" %}

```bash
claude mcp add wearepatchworks --transport http https://doc.wearepatchworks.com/product-documentation/~gitbook/mcp
```

{% endcode %}

For example:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fc0JW4Yi2YGEiVBYBYIdO%2Fclaude%20code.png?alt=media&#x26;token=385f27a6-5a4b-42bc-9990-3af74012c793" alt=""><figcaption></figcaption></figure></div>