Ctrlk
Page cover

MCP server

IcePanel's MCP server is only available on paid plans.

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.

MCP with Claude

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

  • 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

  • VS Code

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.

Connect IcePanel MCP as custom MCP server

Some tools support custom MCP servers. If you want to add IcePanel tools to a tool that supports custom MCP tools, add the following:

Name (if requested): IcePanel MCP server URL: https://mcp.icepanel.io/mcp.

Example in Linear:

Example custom MCP server in Linear

Connect IcePanel MCP to Claude

Introduction

Connect IcePanel to Claude

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

1

Click your profile

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

Click your profile menu to access account settings.

2

Select Settings

Go into Settings to configure our connectors.

Select Settings to configure connectors and integrations.

3

Open Connectors

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

Open Connectors to manage external data sources.

4

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.

5

Add MCP details

Type in:

  • Name: IcePanel

  • MCP server URL: https://mcp.icepanel.io/mcp.

Then click Add to save this configuration.

Type in https://mcp.icepanel.io/mcp and click Add to save the IcePanel MCP server configuration.

6

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.

7

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.

8

Select your IcePanel landscape

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.

9

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.

10

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.

11

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.

12

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.

13

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.

14

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.

15

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.

16

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.

Connect IcePanel MCP to Claude Code

1

Run this command to enable IcePanel MCP:

2

Run claude

3

Run /mcp

4

Select icepanel

5

Select 1 Authenticate

6

Log in and select landscape

Choose which Landscape you want to connect to.

7

Click Allow

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

8

Authentication Successful

9

You're connected!

Test your connection with the cursor chat.

Connect IcePanel to Cursor via MCP

1

Go to Cursor settings

Cursor settings
Cursor settings page

2

Click Tools & MCP's

Tools and MCP settings in Cursor
3

Add Custom MCP

Add Custom MCP tool
4

Add IcePanel MCP:

Add IcePanel Server using:

Example shows just the IcePanel connector.

5

Connect MCP

Connect the new MCP connector
6

Log in and select landscape

Choose which Landscape you want to connect to.

Authenticate and select the IcePanel landscape you want to connect to.

7

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.
8

View tools

9

You're connected!

Test your connection with the cursor chat.

Connect IcePanel MCP to Codex

1

Go to the settings page

2

Navigate to MCP servers

Click on the Add server button.

3

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.

4

Authenticate

Click on the Authenticate button.

5

Select the IcePanel landscape to give access

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

6

You're ready to go!

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

Connect IcePanel MCP to VS Code

1

Open chat customizations from the right menu

2

Click on the '+' button to add a new MCP server

3

Select the http option and enter the IcePanel MCP url

https://mcp.icepanel.io/mcp

4

Click allow and open the authentication browser link

5

Log in and select the landscape

Click allow, and you'll be taken back to VS Code

✉️ Support

  • Reach out to Support if you experience any issues.

📝 License

MIT License

🙏 Acknowledgments

  • Thanks to our beta testers and community members

PreviousVersioningNextREST API

Last updated

Was this helpful?