origo-bc-add-env

Add a Business Central tenant entry to an Origo BC Cowork MCP config with encrypted credentials.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/businesscentralal/origo-bc-plugin --skill origo-bc-add-env
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: origo-bc-add-env
Source: https://github.com/businesscentralal/origo-bc-plugin/tree/main/plugins/origo-bc/skills/origo-bc-add-env
Command: npx skills add https://github.com/businesscentralal/origo-bc-plugin --skill origo-bc-add-env

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It solves the problem of extending an existing Origo BC Cowork setup with an additional Business Central tenant/environment without reinstalling the underlying helper scripts.

Core Features & Use Cases

  • Adds a new bc-<nickname> entry to the Cowork MCP config so Cowork can connect to another BC tenant/company.
  • One-shot config update with end-to-end validation by generating the encrypted credentials blob and validating them via the server list_companies workflow before writing the config.
  • Safety guardrails that prevent exposing secrets in chat, avoid inspecting/decrypting blobs, and perform atomic config writes to avoid broken MCP entries.
  • Platform-aware setup that assumes Origo BC scripts already exist locally and handles Windows/macOS/Linux execution paths.

Quick Start

Tell the user: “Run /origo-bc-add-env and follow the prompts to provide a unique nickname plus tenant/app/environment/auth details, then restart Cowork and verify with mcp__bc-<nickname>__list_companies.”

Frequently Asked Questions about origo-bc-add-env

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new Business Central environment to an existing Cowork MCP configuration?

To add a new Business Central environment to an existing Cowork MCP configuration, run the add-env command and provide a unique nickname plus tenant, app, environment, auth, and company inputs. It generates an encrypted credential blob and validates the connection via list_companies before atomically writing the config file.

What prerequisites do I need before adding a Business Central tenant to Cowork MCP?

Before adding a Business Central tenant to Cowork MCP, you need Node.js 18+ installed and the local OrigoBC helper scripts already present on your machine. The setup is platform-aware and handles execution paths across Windows, macOS, and Linux without reinstalling underlying helpers.

Does adding a Business Central environment require reinstalling local helper scripts?

Adding a Business Central environment does not require reinstalling local helper scripts. The process reuses already-installed local OrigoBC scripts and safely extends your existing MCP configuration by adding a new bc-nickname entry with validated credentials.

How are credentials secured when configuring a new Business Central tenant entry?

Credentials are secured when configuring a Business Central tenant entry by generating an encrypted credential blob using DPAPI and AES wrapping. Safety guardrails prevent exposing secrets in chat, avoid inspecting or decrypting existing blobs, and perform atomic BOM-correct config writes to prevent broken MCP entries.

Why does my Business Central environment configuration fail validation before writing the config?

Business Central environment configuration validation fails when the list_companies workflow cannot verify the generated encrypted credentials against the server. The skill performs this end-to-end validation step before writing the config to ensure the tenant, app, and auth inputs are correct and prevent broken MCP entries.

Can I connect Cowork MCP to multiple Business Central companies using device code authentication?

You can connect Cowork MCP to multiple Business Central companies using device code auth by adding separate bc-nickname entries for each environment. The interactive collection process gathers tenant, app, environment, auth, and company inputs, then validates each set via list_companies before committing the config.