---
title: Set up Claude Code for biGENIUS-X
description: Install the biGENIUS-X plugins in Claude Code and sign in with your biGENIUS-X account.
---

[Skip to content](https://knowledge.bigenius-x.com/set-up-claude-code-for-bigenius-x#main-content)

[Contact us](https://knowledge.bigenius-x.com/kb-tickets/new?hsLang=en) [Go to Customer Portal](https://knowledge.bigenius-x.com/customer-portal?hsLang=en)

[![TRI\_Logo\_biGENIUS\_2020\_RGB\_s](https://knowledge.bigenius-x.com/hs-fs/hubfs/Marketing/TRI_Logo_biGENIUS_2020_RGB_s.png?width=150&height=42&name=TRI_Logo_biGENIUS_2020_RGB_s.png)](https://www.bigenius-x.com/)

Open main navigation

Close main navigation

- [Contact us](https://knowledge.bigenius-x.com/kb-tickets/new)
- [Go to Customer Portal](https://knowledge.bigenius-x.com/customer-portal)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [biGENIUS-X Knowledge Base](https://knowledge.bigenius-x.com/?hsLang=en)
2. [Artificial Intelligence](https://knowledge.bigenius-x.com/artificial-intelligence?hsLang=en)
3. [MCP server](https://knowledge.bigenius-x.com/artificial-intelligence?hsLang=en#mcp-server)

# 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](https://knowledge.bigenius-x.com/connect-other-ai-clients-to-the-mcp-server?hsLang=en).

### Prerequisites

- [Claude Code](https://code.claude.com/docs/en/overview), 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](https://knowledge.bigenius-x.com/understand-git-workflow?hsLang=en).
- [Node.js](https://nodejs.org/en/download), which runs the hooks of the modeling plugin. Without it, Claude Code asks for approval of every upload and download command.
- `tar` and `curl` on the command line. The upload and download commands use them; Windows includes both in `C:\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

1. In the root folder of the metadata repository (the folder with `project.yml`), create the file `.claude/settings.json` with 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 with `bigenius-data-marketplace` when your team only models; then also remove the comma after `true` in the line above it.
2. Commit and push the file. Everyone who opens the repository in Claude Code is asked to trust the folder and to install the plugins; `/plugin` then lists them. Each team member still signs in with their own account.

#### Install for yourself in the terminal

1. 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
   ```
2. Restart Claude Code. `/plugin` lists the installed plugins.

#### Install for yourself in the Claude desktop app

1. Open **Settings**, then **Customize** and **Plugins**.
2. Choose **Add**, then **Add marketplace**, and enter `https://github.com/bigenius-x/claude-plugins`.
3. Install `bigenius-x-modeling` and, 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](https://code.claude.com/docs/en/discover-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

1. Run `/mcp` and select `bigenius-modeling` or `bigenius-marketplace`. A browser window opens.
2. Sign in with your biGENIUS-X account. Claude Code shows the server as connected.
3. When you installed both plugins, repeat the steps for the other server.

#### In the Code tab of the Claude desktop app

1. Start a session in the folder of your project and send a first message. The servers connect only in a running session.
2. Open the MCP servers of the session and choose **Connect** next to `bigenius-modeling` or `bigenius-marketplace`. A browser window opens.
3. Sign in with your biGENIUS-X account. The server shows as connected.
4. 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

1. Open Claude Code in the root folder of the repository and ask:
   
   ```
   Which layers and model objects does the project have?
   ```
2. Claude calls `open_workspace` and runs the upload command; with Node.js installed, it does not ask you. It answers with the layers and model objects of your project.
3. For the Data Marketplace, ask which data products you can see. Claude calls `search_data_products` and lists them.

### Update the plugins

1. In the terminal, run `/plugin marketplace update bigenius`. In the desktop app, update the marketplace under **Settings**, **Customize**, **Plugins**.
2. 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](https://knowledge.bigenius-x.com/mcp-server-troubleshooting?hsLang=en), which also shows how to switch the organization.

More symptoms are in the troubleshooting article.

### Related articles

- Previous: [biGENIUS-X MCP server](https://knowledge.bigenius-x.com/bigenius-x-mcp-server?hsLang=en)
- Next: [Model a biGENIUS-X project with Claude Code](https://knowledge.bigenius-x.com/model-a-bigenius-x-project-with-claude-code?hsLang=en), [Find data products and write SQL with Claude](https://knowledge.bigenius-x.com/find-data-products-and-write-sql-with-claude?hsLang=en)
- See also: [Connect other AI clients to the MCP server](https://knowledge.bigenius-x.com/connect-other-ai-clients-to-the-mcp-server?hsLang=en), [MCP server troubleshooting](https://knowledge.bigenius-x.com/mcp-server-troubleshooting?hsLang=en), [Understand Git Workflow in biGENIUS-X](https://knowledge.bigenius-x.com/understand-git-workflow?hsLang=en)

- [Getting started](https://knowledge.bigenius-x.com/getting-started?hsLang=en#main-content)

    - [Guidelines](https://knowledge.bigenius-x.com/getting-started?hsLang=en#guidelines)
    - [Start working](https://knowledge.bigenius-x.com/getting-started?hsLang=en#start-working)
    - [Account](https://knowledge.bigenius-x.com/getting-started?hsLang=en#account)
- [General overview](https://knowledge.bigenius-x.com/general-overview?hsLang=en)
- [Artificial Intelligence](https://knowledge.bigenius-x.com/artificial-intelligence?hsLang=en#main-content)

    - [MCP server](https://knowledge.bigenius-x.com/artificial-intelligence?hsLang=en#mcp-server)
- [Application Modules](https://knowledge.bigenius-x.com/application-modules?hsLang=en#main-content)

    - [Administration](https://knowledge.bigenius-x.com/application-modules?hsLang=en#administration)
    - [Solutions](https://knowledge.bigenius-x.com/application-modules?hsLang=en#solutions)
    - [Global Features](https://knowledge.bigenius-x.com/application-modules?hsLang=en#global-features)
    - [Projects](https://knowledge.bigenius-x.com/application-modules?hsLang=en#projects)
    - [Branches](https://knowledge.bigenius-x.com/application-modules?hsLang=en#branches)
    - [Data Connections](https://knowledge.bigenius-x.com/application-modules?hsLang=en#data-connections)
    - [Dataflow Modeling - Overview](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-overview)
    - [Dataflow Modeling - Wizard Steps](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-wizard-steps)
    - [Dataflow Modeling - Terms](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-terms)
    - [Dataflow Modeling - Term Mapping](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-term-mapping)
    - [Dataflow Modeling - Relationships](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-relationships)
    - [Dataflow Modeling - Data Quality](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-data-quality)
    - [Dataflow Modeling - Indexes](https://knowledge.bigenius-x.com/application-modules?hsLang=en#dataflow-modeling-indexes)
    - [Relationship Modeling](https://knowledge.bigenius-x.com/application-modules?hsLang=en#relationship-modeling)
    - [Generate Artifacts](https://knowledge.bigenius-x.com/application-modules?hsLang=en#generate-artifacts)
    - [Project Settings](https://knowledge.bigenius-x.com/application-modules?hsLang=en#project-settings)
    - [Data Marketplace](https://knowledge.bigenius-x.com/application-modules?hsLang=en#data-marketplace)
- [Generators](https://knowledge.bigenius-x.com/generators?hsLang=en#main-content)

    - [Databricks](https://knowledge.bigenius-x.com/generators?hsLang=en#databricks)
    - [Databricks dbt](https://knowledge.bigenius-x.com/generators?hsLang=en#databricks-dbt)
    - [Fabric Lakehouse](https://knowledge.bigenius-x.com/generators?hsLang=en#fabric-lakehouse)
    - [Fabric Warehouse](https://knowledge.bigenius-x.com/generators?hsLang=en#fabric-warehouse)
    - [Microsoft SQL Server](https://knowledge.bigenius-x.com/generators?hsLang=en#microsoft-sql-server)
    - [Oracle](https://knowledge.bigenius-x.com/generators?hsLang=en#oracle)
    - [Snowflake](https://knowledge.bigenius-x.com/generators?hsLang=en#snowflake)
    - [Snowflake dbt](https://knowledge.bigenius-x.com/generators?hsLang=en#snowflake-dbt)
    - [Artifacts](https://knowledge.bigenius-x.com/generators?hsLang=en#artifacts)
    - [Replace Placeholders](https://knowledge.bigenius-x.com/generators?hsLang=en#replace-placeholders)
    - [Target solution environment](https://knowledge.bigenius-x.com/generators?hsLang=en#target-solution-environment)
    - [Deployment](https://knowledge.bigenius-x.com/generators?hsLang=en#deployment)
    - [Deployment with an Azure DevOps pipeline](https://knowledge.bigenius-x.com/generators?hsLang=en#deployment-with-an-azure-devops-pipeline)
    - [Delta Deployment](https://knowledge.bigenius-x.com/generators?hsLang=en#delta-deployment)
    - [Load control environment](https://knowledge.bigenius-x.com/generators?hsLang=en#load-control-environment)
    - [Load data with a native load control](https://knowledge.bigenius-x.com/generators?hsLang=en#load-data-with-a-native-load-control)
    - [Load data with Apache Airflow](https://knowledge.bigenius-x.com/generators?hsLang=en#load-data-with-apache-airflow)
    - [Model Object Type](https://knowledge.bigenius-x.com/generators?hsLang=en#model-object-type)
    - [Properties](https://knowledge.bigenius-x.com/generators?hsLang=en#properties)
    - [Default Terms](https://knowledge.bigenius-x.com/generators?hsLang=en#default-terms)
- [Discovery application](https://knowledge.bigenius-x.com/discovery-application?hsLang=en#main-content)

    - [Discovery configurations](https://knowledge.bigenius-x.com/discovery-application?hsLang=en#discovery-configurations)
- [Best practices](https://knowledge.bigenius-x.com/best-practices?hsLang=en#main-content)

    - [Modeling Approaches](https://knowledge.bigenius-x.com/best-practices?hsLang=en#modeling-approaches)
    - [Use Cases](https://knowledge.bigenius-x.com/best-practices?hsLang=en#use-cases)
    - [Business Rules](https://knowledge.bigenius-x.com/best-practices?hsLang=en#business-rules)
    - [Data Quality Rules](https://knowledge.bigenius-x.com/best-practices?hsLang=en#data-quality-rules)
- [FAQs](https://knowledge.bigenius-x.com/faqs?hsLang=en)
- [Product Release Notes](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#main-content)

    - [SaaS Application](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#saas-application)
    - [Discovery application](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#discovery-application)
    - [Generators](https://knowledge.bigenius-x.com/product-release-notes?hsLang=en#generators)
- [Legal Documents](https://knowledge.bigenius-x.com/legal-documents?hsLang=en#main-content)

    - [Current legal docs](https://knowledge.bigenius-x.com/legal-documents?hsLang=en#current-legal-docs)
    - [Software Product and Limits](https://knowledge.bigenius-x.com/legal-documents?hsLang=en#software-product-and-limits)

- [Contact us](https://knowledge.bigenius-x.com/kb-tickets/new?hsLang=en)
- [Customer Portal](https://knowledge.bigenius-x.com/customer-portal)
- [Sign in](https://knowledge.bigenius-x.com/_hcms/mem/login)

[![biGENIUS logo](https://knowledge.bigenius-x.com/hubfs/TRI_Logo_biGENIUS_2020_RGB-1.svg "biGENIUS logo")](https://www.bigenius-x.com)

<https://www.linkedin.com/company/bigenius> <https://www.youtube.com/@biGENIUS_DWA>

All rights reserved © 2025, biGENIUS AG