# MCP server

{% hint style="info" %}
IcePanel's MCP server is only available on paid plans.
{% endhint %}

IcePanel contains a rich amount of data about your software architecture; everything from systems, apps, stores, components, relationships, and the details about them. As your model grows, making sense of your architecture gets harder.

Connect your data in IcePanel with your LLM of choice and ask it questions to quickly get answers about your software architecture.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FKk48EE7KUvNtyp86wCfR%2Fmcp-server.gif?alt=media&#x26;token=55991e3c-c7bb-47b4-b3e3-60d379183ac9" alt=""><figcaption><p>MCP with Claude</p></figcaption></figure>

### How it works

After configuring your AI client with IcePanel, you’ll be able to ask it things like:

* What are my landscapes?
* Details about any model objects — “What does IcePanel do?”
* Object relationships — “What is this API service connected to?”
* Technology information — “What are the most commonly used tech in my system?”
* Team ownership — “What does *team X* own?”
* Verifying designs with decisions — "Does this architecture reflect our decision records?"
* Add objects and connections

### ✅ Supported MCP tools

#### Read tools (list and details):

* Model object, domain and connections
* Diagram and flow contents
* Team, technology choice, tags
* Decision records (ADRs)

#### Write/delete tools (create and update)

* Model object and connection
* Decision records (ADRs)

### ❌ Unsupported MCP tools

* Diagram create&#x20;
* Draft tools
* Version tools
* Comment tools

## Tools you can connect to

Check your tools for "Custom MCP connectors"

We've tested with:

* Claude
* Claude code
* Codex
* Cursor

## Enable OAuth access in IcePanel for write

By default, all editors and admins in IcePanel can setup MCP with read access. Write access is disabled by default for existing organizations. To enable it, go to the AI settings page and toggle OAuth write access.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FzkJXzAeRXtbCVV87vi06%2FScreenshot%202026-04-07%20at%2010.40.50%E2%80%AFAM.png?alt=media&#x26;token=5e290dad-5672-4dbd-afd7-7b35e7e23f55" alt=""><figcaption></figcaption></figure>

## Connect IcePanel MCP to Claude

{% embed url="<https://studio.saltfish.ai/demo-share/demo_1774301843171_zggw37zpi>" %}

### Introduction

**Connect IcePanel to Claude**

Set up the IcePanel MCP connector so Claude can access and query your architecture data directly.

{% stepper %}
{% step %}

### Click your profile

Start in Claude and click on your profile menu to access the settings.

![Click your profile menu to access account settings.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_1.jpg)

{% endstep %}

{% step %}

### Select Settings

Go into Settings to configure our connectors.

![Select Settings to configure connectors and integrations.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_2.jpg)

{% endstep %}

{% step %}

### Open Connectors

Open up the Connectors section where we can manage external data sources.

![Open Connectors to manage external data sources.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_3.jpg)

{% endstep %}

{% step %}

### Add a custom connector

Click Add custom connector to start linking IcePanel to your Claude instance.

![Click Add custom connector to start linking IcePanel to Claude.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_4.jpg)

{% endstep %}

{% step %}

### Add MCP details&#x20;

Type in:

* Name: IcePanel
* MCP server URL: <https://mcp.icepanel.io/mcp>.

&#x20;Then click Add to save this configuration.

![Type in https://mcp.icepanel.io/mcp and click Add to save the IcePanel MCP server configuration.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_5.jpg)

{% endstep %}

{% step %}

### Click Connect

Click Connect, and this will take you through the authentication process to authorize access to your IcePanel account.

![Click Connect to authenticate and authorize access to your IcePanel account.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_6.jpg)

{% endstep %}

{% step %}

### Open the landscape dropdown

This is where you'll select which IcePanel landscape you want to connect to.

![Open the landscape dropdown to choose which IcePanel project Claude can access.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_8.jpg)

{% endstep %}

{% step %}

### Select your IcePanel landscape&#x20;

Choose which Landscape you want to connect to.

![Select the IcePanel landscape you want to connect from the list to grant read access to this landscape.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_9.jpg)

{% endstep %}

{% step %}

### Click Allow

Click Allow to authorize Claude to read your architecture data from this landscape.

![Click Allow to authorize Claude to read your IcePanel architecture data.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_10.jpg)

{% endstep %}

{% step %}

### Click Configure

Cool! Now that the connection is established, click Configure to set up permissions for the available tools.

![Click Configure to review and set permissions for the IcePanel tools.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_12.jpg)

{% endstep %}

{% step %}

### Review tools for Claude access

Here you can see all the tools that Claude can use with IcePanel.

![Review the available read-only tools so you can control what Claude can access.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_13.jpg)

{% endstep %}

{% step %}

### Recommended: select Always allow for the read-only tools

This will allow Claude to automatically query your data without needing approval each time. Keep an eye on this list for future tools.

![We recommend selecting Always allow for the read-only tools to enable automatic queries without approval prompts.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_14.jpg)

{% endstep %}

{% step %}

### Configured!

Great! Your IcePanel connector is now fully configured with all the tool permissions set.

![Your IcePanel connector is now fully configured with tool permissions set.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_15.jpg)

{% endstep %}

{% step %}

### Test it

Start a new chat so I can show you how to query your IcePanel data.

![Test it with a new chat to start a conversation where you can query your IcePanel data.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_16.jpg)

{% endstep %}

{% step %}

### Enter example query

Ask questions like, "list all of the Cloud Run services in my IcePanel landscape".

![Enter a query in the chat input to test the IcePanel integration with Claude.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_17.jpg)

{% endstep %}

{% step %}

### Response

And there you have it! Claude uses the IcePanel integration to pull back all of your Cloud Run services with details like service names, regions, and visibility settings. This is a simple example, but you can do much more complex queries.

![Here you can see a detailed table listing all GCP Cloud Run services in the IcePanel landscape, including service names, captions, hostnames, regions, and visibility settings.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_18.jpg)

{% endstep %}
{% endstepper %}

***

## Connect IcePanel to Cursor via MCP

{% stepper %}
{% step %}

### Go to Cursor settings

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FvSMdfGMmKtRH60Mgq7MY%2Fimage.png?alt=media&#x26;token=88844354-f762-478d-a37b-b4d8552e92de" alt="Cursor settings"><figcaption><p>Cursor settings page</p></figcaption></figure>

{% endstep %}

{% step %}

### Click Tools & MCP's

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FQn33nf0qKpESNLsh95w5%2Fimage.png?alt=media&#x26;token=52b4bbc5-68fd-449b-b66a-6567e52d256b" alt=""><figcaption><p>Tools and MCP settings in Cursor</p></figcaption></figure>
{% endstep %}

{% step %}

### Add Custom MCP

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FSFkmLnXgq8xo7PBUd3Gk%2Fimage.png?alt=media&#x26;token=ca80d669-7e9c-4592-8d0d-c802ccfa180b" alt=""><figcaption><p>Add Custom MCP tool</p></figcaption></figure>
{% endstep %}

{% step %}

### Add IcePanel MCP:

Add IcePanel Server using:

```jsonc
{
  "mcpServers": {
    "icepanel": {
      "type": "streamable-http",
      "url": "https://mcp.icepanel.io/mcp",
      "note": "For Streamable HTTP connections, add this URL directly in your MCP Client"
    }
  }
}
```

*Example shows just the IcePanel connector.*
{% endstep %}

{% step %}

### Connect MCP

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FjszdWFHGOIUyFJ39o2ZF%2Fimage.png?alt=media&#x26;token=b054526d-8cb0-4a33-a99c-179385f9aa39" alt=""><figcaption><p>Connect the new MCP connector</p></figcaption></figure>
{% endstep %}

{% step %}

### Log in and select landscape

Choose which Landscape you want to connect to.

![Authenticate and select the IcePanel landscape you want to connect to.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_9.jpg)

{% endstep %}

{% step %}

### Click Allow

Click Allow to authorize Claude to read your architecture data from this landscape.

![Click Allow to authorize Claude to read your IcePanel architecture data.](https://storage.saltfish.ai/demo-recordings/demo_1774301843171_zggw37zpi/step_10.jpg)
{% endstep %}

{% step %}

### View tools

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2Fh5SdevFmnfiZHtlqF3xH%2Fimage.png?alt=media&#x26;token=26cea452-a9a3-46d4-982d-277a823f35a3" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### You're connected!

Test your connection with the cursor chat.
{% endstep %}
{% endstepper %}

***

## Connect IcePanel MCP to Claude Code

{% stepper %}
{% step %}

### Run this command to enable IcePanel MCP:

```
claude mcp add --transport http icepanel https://mcp.icepanel.io/mcp
```

{% endstep %}

{% step %}

### Run claude

```
claude
```

{% endstep %}

{% step %}

### Run /mcp

```
/mcp
```

{% endstep %}

{% step %}

### Select icepanel

{% endstep %}

{% step %}

### Select 1 Authenticate

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FogVfbGDwOkHouEEKqlY5%2Fimage.png?alt=media&#x26;token=925785f0-4640-48e9-b05e-b3342513540d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Log in and select landscape

Choose which Landscape you want to connect to.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FXJ3RW7Xrte1DQZclNUhZ%2Fimage.png?alt=media&#x26;token=fb5a690d-acac-464e-be0a-30d568db1ac5" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Click Allow

Click Allow to authorize Claude to read your architecture data from this landscape.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FPvvHYIKmFHfy74vNxi1t%2Fimage.png?alt=media&#x26;token=ec5bfa9a-b3ef-468f-b30f-05e0eb943f34" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Authentication Successful

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2Fw6B7LpuHDabuUkd1Zsti%2Fimage.png?alt=media&#x26;token=31cccb4b-4f09-4ba5-bb94-3bf00a3e07f6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### You're connected!

Test your connection with the cursor chat.
{% endstep %}
{% endstepper %}

## Connect IcePanel MCP to Codex

{% stepper %}
{% step %}

### Go to the settings page

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FWjQ12FYQsGfPCIdVfDsa%2FScreenshot%202026-04-06%20at%201.45.46%E2%80%AFPM.png?alt=media&#x26;token=6fa5bdd5-0267-4a0f-aa62-a758a85f4d92" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Navigate to MCP servers

Click on the `Add server` button.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FUCF8DVCuqSvIb9ptLb9Q%2FScreenshot%202026-04-06%20at%201.46.02%E2%80%AFPM.png?alt=media&#x26;token=a6ea75ee-135d-4707-bc88-0984123378a8" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Give the MCP a name and paste the IcePanel MCP url

Paste <https://mcp.icepanel.io/mcp> into the URL field. Leave everything else blank and click save.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FM6xBUE5qt9MoXY8pb4HC%2FScreenshot%202026-04-06%20at%201.46.19%E2%80%AFPM.png?alt=media&#x26;token=61cfff08-a446-4234-ab8b-f105f61f79b3" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Authenticate

Click on the `Authenticate` button.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FwHWAvcKrhBzahxoKPwOP%2FScreenshot%202026-04-06%20at%202.00.09%E2%80%AFPM.png?alt=media&#x26;token=c3fc8478-b298-4b2a-a0b3-9ea3d1ed63fd" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Select the IcePanel landscape to give access

Choose the landscape and click allow. You'll see a plain text confirmation screen in the browser.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FuEXWo5x8o5Zvc7X2p936%2FScreenshot%202026-04-06%20at%202.09.22%E2%80%AFPM.png?alt=media&#x26;token=8254dfb7-4a5e-43a8-8309-82de88f7ece6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### You're ready to go!

Start chatting. Note that Codex doesn't allow for custom tool permissions.

<figure><img src="https://4065434276-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOHewp5hylgOsOa0VDOBo%2Fuploads%2FNbzGcFLb9TXR0whsAGqV%2FScreenshot%202026-04-06%20at%202.02.46%E2%80%AFPM.png?alt=media&#x26;token=5631e5a3-8150-405e-9c88-53f11391fd09" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### ✉️ Support

* Reach out to [Support](mailto:support@icepanel.io) if you experience any issues.

### 📝 License

MIT License

### 🙏 Acknowledgments

* Thanks to our beta testers and community members