Set up Claude Code for biGENIUS-X
Applies to
License: MCP Server
Install the biGENIUS-X plugins in Claude Code and sign in with your biGENIUS-X account. Do this once per machine, or once per repository for your whole team. Afterwards Claude Code can read and change your biGENIUS-X project and query the Data Marketplace.
This article covers Claude Code in the terminal and in the Code tab of the Claude desktop app. For the Claude desktop chat, claude.ai, Codex, Visual Studio and Visual Studio Code, see Connect other AI clients to the MCP server.
Prerequisites
- Claude Code, in the terminal or in the Code tab of the Claude desktop app.
- Git, and the metadata repository of your biGENIUS-X project cloned on your machine. See Understand Git Workflow in biGENIUS-X.
- Node.js, which runs the hooks of the modeling plugin. Without it, Claude Code asks for approval of every upload and download command.
tarandcurlon the command line. The upload and download commands use them; Windows includes both inC:\Windows\System32.- A biGENIUS-X account in an organization whose license includes MCP Server. The Data Marketplace plugin also needs the Data Marketplace, which is part of the Enterprise plan.
Install the plugins
Choose one of the three ways. Each installs the server entry, a skill that describes the working process to Claude, and for bigenius-x-modeling two hooks: one reminds Claude to change the model structure only through the tools, the other allows the upload and download commands of the project files without a prompt.
Install for your team in the repository
- In the root folder of the metadata repository (the folder with
project.yml), create the file.claude/settings.jsonwith this content, or add these entries to the existing file:{ "extraKnownMarketplaces": { "bigenius": { "source": { "source": "github", "repo": "bigenius-x/claude-plugins" } } }, "enabledPlugins": { "bigenius-x-modeling@bigenius": true, "bigenius-data-marketplace@bigenius": true } }Leave out the line withbigenius-data-marketplacewhen your team only models; then also remove the comma aftertruein the line above it. - Commit and push the file. Everyone who opens the repository in Claude Code is asked to trust the folder and to install the plugins;
/pluginthen lists them. Each team member still signs in with their own account.
Install for yourself in the terminal
- In Claude Code, run these commands. Leave out the last one when you only model.
/plugin marketplace add bigenius-x/claude-plugins /plugin install bigenius-x-modeling@bigenius /plugin install bigenius-data-marketplace@bigenius
- Restart Claude Code.
/pluginlists the installed plugins.
Install for yourself in the Claude desktop app
- Open Settings, then Customize and Plugins.
- Choose Add, then Add marketplace, and enter
https://github.com/bigenius-x/claude-plugins. - Install
bigenius-x-modelingand, when you need it,bigenius-data-marketplace. Both appear as installed in the plugin list.
Anthropic describes plugins and marketplaces in Install and manage plugins.
Sign in
Claude Code works with your biGENIUS-X sign-in, so it gets the same access as you in the web app. When you belong to several organizations, choose the organization whose license includes MCP Server on the sign-in page.
In the terminal
- Run
/mcpand selectbigenius-modelingorbigenius-marketplace. A browser window opens. - Sign in with your biGENIUS-X account. Claude Code shows the server as connected.
- When you installed both plugins, repeat the steps for the other server.
In the Code tab of the Claude desktop app
- Start a session in the folder of your project and send a first message. The servers connect only in a running session.
- Open the MCP servers of the session and choose Connect next to
bigenius-modelingorbigenius-marketplace. A browser window opens. - Sign in with your biGENIUS-X account. The server shows as connected.
- When you installed both plugins, repeat the steps for the other server.
The sign-in is valid for 24 hours. After that, sign in again the same way.
Example
Example: a team adds .claude/settings.json with both plugins to its project repository. A team member pulls the change, opens the folder in Claude Code, trusts it, installs the two plugins and runs /mcp to sign in to bigenius-modeling.
Check the result
- Open Claude Code in the root folder of the repository and ask:
Which layers and model objects does the project have?
- Claude calls
open_workspaceand runs the upload command; with Node.js installed, it does not ask you. It answers with the layers and model objects of your project. - For the Data Marketplace, ask which data products you can see. Claude calls
search_data_productsand lists them.
Update the plugins
- In the terminal, run
/plugin marketplace update bigenius. In the desktop app, update the marketplace under Settings, Customize, Plugins. - Restart Claude Code.
Failure symptoms and recovery
The bigenius tools are missing
Cause: the server is not connected, or the sign-in has expired.
Fix: run /mcp in the terminal, or in the Code tab open the MCP servers of a running session, and connect the server again.
A tool reports that the license does not include the MCP server
Message: The biGENIUS-X license of your organization does not include the MCP server. Contact your biGENIUS-X administrator.
Cause: the organization you signed in with has no MCP Server license.
Fix: follow the license entry in MCP server troubleshooting, which also shows how to switch the organization.
More symptoms are in the troubleshooting article.
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: Connect other AI clients to the MCP server, MCP server troubleshooting, Understand Git Workflow in biGENIUS-X