Connect with MCP

The Model Context Protocol (MCP) is an open standard that lets AI assistants work with other tools. With the Dimension MCP server, your assistant can build and manage your Dimension workspaces from a conversation: data feeds, actions, Studio apps and the workspaces themselves.

Before you start

You need:

A Dimension account with access to at least one workspace
One of the assistants below

Get your setup from Dimension

The quickest way to connect is to copy the setup from Dimension itself, because it already includes your tenant’s address.

Click your avatar in the top-right, then Connect MCP.
Expand your assistant. The list covers Claude Code, Claude Desktop, Visual Studio Code, Visual Studio, GitHub Copilot CLI and OpenAI Codex.
Copy the command or configuration, and follow the instructions for your assistant below.
Authorise the connection when your browser opens.

Connect MCP dialog with Claude Code expanded, showing the claude mcp add command for your tenant, and collapsed sections for Claude Desktop, Visual Studio Code, Visual Studio, GitHub Copilot CLI and OpenAI Codex

The assistant then acts as you. It can only do what your role already permits, in the workspaces you already belong to.

Set up your assistant

The examples below use <your-tenant> in place of your tenant’s address. If anything differs from the Connect MCP dialog, use what the dialog shows.

Anthropic’s agentic coding tool. Run this in your terminal:

claude mcp add --transport http dimension https://<your-tenant>.dimension.io/mcp/code

See Claude Code’s MCP guide.

Anthropic’s desktop app, which connects to remote MCP servers as custom connectors.In Claude Desktop, open Settings → Connectors → Add custom connector, and paste this URL. Leave Advanced settings empty.

https://<your-tenant>.dimension.io/mcp/chat

See Claude’s custom connectors guide.

Microsoft’s code editor, with MCP servers available in GitHub Copilot’s agent mode. Add this to .vscode/mcp.json in your workspace:

{
  "servers": {
    "dimension": {
      "type": "http",
      "url": "https://<your-tenant>.dimension.io/mcp/code"
    }
  }
}

See VS Code’s MCP guide.

Microsoft’s IDE, with MCP servers available in Copilot’s agent mode in Visual Studio 2026, or Visual Studio 2022 version 17.14 and later. Add this to .mcp.json next to your solution file:

{
  "servers": {
    "dimension": {
      "type": "http",
      "url": "https://<your-tenant>.dimension.io/mcp/code"
    }
  }
}

See Visual Studio’s MCP guide.

GitHub’s terminal-based agent. Run this in your terminal:

copilot mcp add --transport http dimension https://<your-tenant>.dimension.io/mcp/code

See GitHub Copilot CLI’s MCP guide.

OpenAI’s coding agent. The CLI, desktop app and IDE extension share this configuration. Run this in your terminal, then approve the connection when your browser opens:

codex mcp add dimension --url https://<your-tenant>.dimension.io/mcp/code && codex mcp login dimension

See Codex’s MCP guide.

What you can do

Area	What your assistant can do
Workspaces	List your workspaces and what’s in them, create workspaces and edit them
Data Feeds	Create feeds, edit their requests, code, triggers and variables, test them, refresh them and publish them
Actions	Create actions, edit their email or webhook, trigger and variables, test them and publish them
Studio apps	Create apps, add data feeds and actions to them, export an app to work on locally, import it back and publish it
Key-value stores	Read and write an app’s key-value store
Usage	Check your usage

Changes start as drafts. Nothing goes live until it’s published, so test feeds and actions before you publish them. The server also offers ready-made prompts that walk your assistant through common jobs: scaffold_feed, scaffold_action, scaffold_app and plan_from_goal. They appear in your assistant’s prompt picker. In Claude Code, for example, run /mcp__labs__scaffold_feed.

Example prompts

“List my workspaces and the data feeds in each.”
“Create a data feed in the Identity workspace that pulls users from our identity provider’s API, then test it.”
“Build a Studio app that shows MFA enrolment by department from the Identity feed.”
“Add an action to the Patch management app that emails the IT team a weekly summary.”

Security and permissions

The server acts as you. Every request runs with your account’s role, workspace membership and access to Dimension, so it can only see and change what you can.
Changes stay as drafts until they’re published.
You can remove the server at any time from your assistant’s settings.

See Security & Privacy for how Dimension handles your data.

Troubleshooting

The server doesn't connect

Check that you’ve used your own tenant’s URL, and that your organisation allows custom MCP servers in your assistant.

The assistant can't find a workspace

The server only sees workspaces your account can access. Check your workspace visibility.

Get started

Core Concepts

Build

Reference

Settings

Trust & Security