MCP server (beta)

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.

What is MCP?

The Model Context Protocol (MCP) is a standard for applications to communicate with LLMs. Anthropic created MCP in November 2024, and it has quickly gained widespread adoption. Think of it as a layer between your app and LLMs, a “USB-C port for AI applications”.

MCP is an open protocol supported by most apps like Cursor, Claude and CoPilot. ChatGPT plans on releasing an integration soon. IcePanel’s MCP integration will work with any app that supports tools.

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?”

MCP with Claude

Setup

Prerequisites

• Node.js (Latest LTS version recommended)

• One of the supported MCP Clients:

  • Claude Desktop

  • Cursor

  • Windsurf

Installation

1. Get your organization's ID

   • Visit IcePanel
   • Click on your landscape in the top left to open the dropdown

   • Beside your org name, click the gear icon

   • Keep your "Organization Identifier" handy!

2. Generate API Key

   • Visit IcePanel
   • Click on your landscape in the top left to open the dropdown

   • Beside your org name, click the gear icon

   • Click on the 🔑 API keys link in the sidebar

   • Generate a new API key

   • Read permissions recommended

3. Install

   • https://github.com/IcePanel/mcp-server

Environment Variables

• API_KEY: Your IcePanel API key (required)

• ORGANIZATION_ID: Your IcePanel organization ID (required)

• ICEPANEL_API_BASE_URL: (Optional) Override the API base URL for different environments

Configure your MCP Client

Add this to your MCP Clients' MCP config file:

{
  "mcpServers": {
    "@icepanel/icepanel": {
      "command": "npx",
      "args": ["-y", "@icepanel/mcp-server@latest", "API_KEY=\"your-api-key\"", "ORGANIZATION_ID=\"your-org-id\""]
    }
  }
}

✉️ Support

• Reach out to Support if you experience any issues.

📝 License

MIT License

🙏 Acknowledgments

• Thanks to our beta testers and community members