Connect other AI clients to the MCP server
Applies to
License: MCP Server
Connect the Claude desktop chat, claude.ai, Codex, or GitHub Copilot in Visual Studio or Visual Studio Code to the biGENIUS-X MCP server. Use this when you do not work in Claude Code, where the plugins set up the connection. Afterwards your assistant can call the modeling or Data Marketplace tools with your biGENIUS-X sign-in.
Plugins and hooks exist only in Claude Code; in these clients you add the server entry yourself. For Claude Code, see Set up Claude Code for biGENIUS-X.
Prerequisites
- A biGENIUS-X account in an organization whose license includes MCP Server; for the Data Marketplace endpoint also the Data Marketplace (Enterprise plan).
- For modeling in Codex, Visual Studio or Visual Studio Code: the metadata repository of your project cloned on your machine, and
tarandcurlon the command line.
Server URLs
- Modeling:
https://mcp.bigenius-x.com/modeling - Data Marketplace:
https://mcp.bigenius-x.com/marketplace
Every client signs in through the browser with your biGENIUS-X account. The server needs no client ID, client secret or API key.
Connect a client
Claude chat on the desktop and on the web
- Open Settings, then Connectors, and choose Add custom connector. Enter one of the server URLs. See Anthropic's Get started with custom connectors using remote MCP.
- Sign in with your biGENIUS-X account. The connector shows as connected.
- Optional: add the skill. Download bigenius-x/claude-plugins as a ZIP file, pack the folder
plugins/<plugin>/skills/<plugin>itself into a ZIP file of its own, so that the ZIP file contains<plugin>/SKILL.md, and upload it under Settings, Capabilities, Skills. Here<plugin>isbigenius-x-modelingorbigenius-data-marketplace.
The Data Marketplace works in the chat as in Claude Code. Modeling in the chat has no access to your repository: you attach project.yml, config.yml, views/*.yml and the model object files, at most 1 MB in total. When a tool needs more files, Claude asks for them. Claude returns the changed files, and you copy them into the repository yourself. For larger projects, use Claude Code.
Codex
The commands apply to the Codex CLI, the IDE extension and the desktop app.
- Add the server:
codex mcp add bigenius-modeling --url https://mcp.bigenius-x.com/modeling
- Sign in. A browser window opens for your biGENIUS-X account.
codex mcp login bigenius-modeling
For the Data Marketplace, add bigenius-marketplace with its URL the same way. Install the skill as well: save SKILL.md from the folder plugins/bigenius-x-modeling/skills/bigenius-x-modeling of bigenius-x/claude-plugins as .agents/skills/bigenius-x-modeling/SKILL.md in your repository. Codex reads skills from .agents/skills.
OpenAI describes MCP servers in the Codex documentation.
Visual Studio
You need Visual Studio 2022 version 17.14 or later, or Visual Studio 2026, and a GitHub Copilot subscription. Copilot in agent mode runs the upload and download commands in the terminal, as Claude Code does.
- Open the folder of your project with File, Open, Folder: the folder with
project.yml. - Create the file
%USERPROFILE%\.mcp.json:{ "servers": { "bigenius-modeling": { "url": "https://mcp.bigenius-x.com/modeling" } } } - Open the file in Visual Studio, choose Authentication Required above
bigenius-modeling, then Authenticate, and sign in in the browser. - In the Copilot chat, switch from Ask to Agent. When Copilot asks before the upload and download commands, choose Allow, preferably for the session.
- Open Tools and select the tools of
bigenius-modeling. Visual Studio turns off the tools of a new server until you select them. - Save
SKILL.mdfrom the folderplugins/bigenius-x-modeling/skills/bigenius-x-modelingof bigenius-x/claude-plugins as.github/skills/bigenius-x-modeling/SKILL.mdin your repository. Visual Studio 2026 version 18.5 and later read the skill; with an older version, name the tools in your prompts.
For the Data Marketplace, add a second entry bigenius-marketplace with its URL, here and in Visual Studio Code, and save the skill of bigenius-data-marketplace next to the modeling skill.
Microsoft describes MCP servers in Visual Studio in Use MCP Servers to Extend GitHub Copilot.
Visual Studio Code
You need a GitHub Copilot subscription. Copilot in agent mode runs the upload and download commands in the terminal, as in Visual Studio.
- Create the file
.vscode/mcp.jsonin your repository:{ "servers": { "bigenius-modeling": { "type": "http", "url": "https://mcp.bigenius-x.com/modeling" } } } - Choose Start above
bigenius-modelingin the file and sign in in the browser. - In the Copilot chat, select the Agent mode.
- Save the skill as
.github/skills/bigenius-x-modeling/SKILL.md, as for Visual Studio.
Microsoft describes MCP servers in Add and use MCP servers in Visual Studio Code.
GitHub Copilot CLI
The GitHub Copilot CLI has not been tested with the MCP server.
Microsoft Copilot Studio
Copilot Studio cannot be used for modeling: it has neither access to your repository nor a terminal for the upload and download commands.
Example
Example: a data engineer works in Visual Studio Code. They add .vscode/mcp.json with the Modeling endpoint, sign in with Start, save the skill under .github/skills/, switch Copilot to Agent and ask:
Open the workspace with open_workspace and list the views with list_views.
Check the result
Ask which layers and model objects the project has. The assistant calls the biGENIUS-X tools and answers with the model objects of your project. Codex and GitHub Copilot may ask you to confirm the upload and download commands. In the Claude chat, attach the project files first; for the Data Marketplace, ask which data products you can see.
Failure symptoms and recovery
GitHub Copilot reads the YAML files instead of using the tools
Cause: the tools are not selected, the skill is missing, or the mode is not Agent.
Fix: in Visual Studio, open Tools and select the tools of bigenius-modeling. Check that the skill is at .github/skills/bigenius-x-modeling/SKILL.md. Name the tools in the prompt, as in the example.
Sign-in and license errors are in MCP server troubleshooting.
Related articles
- Previous: biGENIUS-X MCP server
- Next: Model a biGENIUS-X project with Claude Code, Find data products and write SQL with Claude
- See also: Set up Claude Code for biGENIUS-X, MCP server troubleshooting