origo-bc · plugin

Tengdu Claude við Business Central

origo-bc tengir Claude Desktop við Origo Business Central MCP-þjón. Eitt plugin sem virkar í bæði Cowork og Code.

Uppsetning  ·  Entra skráning  ·  Fyrsta tenging  ·  Útgáfur

Connect Claude to Business Central

origo-bc wires Claude Desktop up to the Origo Business Central MCP server. One plugin that works in both Cowork and Code.

Installation  ·  Entra app  ·  First connection  ·  Versions

Hvað færðu

Áður en þú byrjar

Node.js 18 eða nýrra

Bæði Cowork og Code nota lítið Node-ferli til að tengjast. Athugaðu hvort Node sé uppsett: 

node --version

Ef skipunin finnst ekki, sæktu LTS-útgáfu frá nodejs.org og endurræstu Claude Desktop á eftir.

Uppsetning

Tvær leiðir til að setja upp — GitHub Marketplace er ráðlögð og virkar í bæði Cowork og Code.

GitHub Marketplace Ráðlögð

Sett upp í gegnum claude CLI. Virkar í bæði Cowork og Code og uppfærist auðveldlega.

Marketplace uppsetning →

Sækja .plugin skrá

Handvirk niðurhal á .plugin-skrá. Nytsamlegt ef þú vilt ekki nota CLI eða ert í Cowork.

Sækja skrá →

Leið A — GitHub Marketplace (ráðlögð)

Þú þarft claude CLI á PATH. Ef þú ert ekki með það, settu það upp fyrst:

macOS

# Homebrew (ráðlagt)
brew install claude

# eða npm
npm install -g @anthropic-ai/claude-code

Windows

npm install -g @anthropic-ai/claude-code

Athugaðu uppsetningu:

claude --version

Keyrðu svo tvær skipanir:

claude plugin marketplace add businesscentralal/origo-bc-plugin
claude plugin install origo-bc@origo-bc

Fyrri skipunin skráir origo marketplace-ið. Seinni sækir nýjustu origo-bc útgáfuna og setur hana upp í ~/.claude/plugins/. Endurræstu Claude Desktop eða opnaðu nýtt spjall svo skilgreiningarnar hleðst inn.

Virkar í báðum hamum Plugin sem er sett upp í gegnum CLI er virkt í bæði Cowork og Code — ekki þarf sérstaka uppsetningu í hvorum ham.

Uppfærsla:

claude plugin update origo-bc@origo-bc

Til að fjarlægja: claude plugin uninstall origo-bc

Uppsetning í gegnum Cowork viðmót

Ef þú ert í Cowork geturðu líka sett upp plugin-ið beint í viðmótinu án CLI. Hér eru skrefin:

1
Smelltu á Customize

Í hliðarstikunni í Cowork, smelltu á Customize.

Cowork hliðarstika — Customize valmöguleiki
2
Bættu við plugin

Smelltu á + við hliðina á Personal plugins eða Add plugin hnappinn.

Customize síða — Add plugin hnappur
3
Veldu Add marketplace

Smelltu á Create plugin → Add marketplace.

Create plugin valmynd — Add marketplace
4
Sláðu inn marketplace slóð og smelltu á Sync

Í URL reitinn, sláðu inn: businesscentralal/origo-bc-plugin og smelltu á Sync.

Add marketplace gluggi — businesscentralal/origo-bc-plugin
5
Staðfestu í Personal flipanum

Plugin-ið birtist undir Personal flipanum sem Origo bc frá Origo hf.

Plugin Directory — Origo bc undir Personal
6
Virkjaðu sjálfvirka samstillingu

Smelltu á … við hliðina á plugin-inu og kveiktu á Sync automatically. Þá uppfærist plugin-ið sjálfkrafa þegar ný útgáfa birtist.

Plugin valmynd — Sync automatically kveikt
7
Smelltu á Install

Opnaðu plugin-ið og smelltu á Install. Þú sérð 6 skills sem fylgja með.

Origo bc plugin — Install hnappur og 6 skills
8
Keyra /origo-bc-setup

Opnaðu nýtt spjall og sláðu inn /origo-bc-setup til að tengja við Business Central.

Leið B — Sækja .plugin skrá

Sæktu skrána í vafra (Edge, Chrome, Firefox — ekki inni í Claude) og dragðu hana í Cowork spjall.

Sækja origo-bc.plugin Eða velja útgáfu →

Uppsetning í Cowork:

  1. Opnaðu File Explorer og farðu í Downloads.
  2. Opnaðu nýtt Cowork spjall.
  3. Dragðu origo-bc.plugin beint í innsláttarreitinn.
  4. Smelltu á Send. Ekki hætta við.
  5. Claude svarar með uppsetningakorti — smelltu á Install.

Eða í gegnum stillingar: Settings → Plugins → Install from file og veldu skrána.

Ef uppsetningarkort birtist ekki Athugaðu: (1) þú ert í Cowork, ekki venjulegu spjalli; (2) þú drógst skrána, ekki URL; (3) þú smelltir á Send.

Entra App Registration

MCP-þjónninn á dynamics.is/api/mcp auðkennir gegn Microsoft Entra (áður Azure AD). Tvær auðkenningarleiðir eru studdar — veldu þá sem hentar:

Client Secret

Forritið keyrir sjálfstætt (unattended). MCP-þjónninn notar app_access réttindi. Hentar fyrir sjálfvirkan aðgang.

Client Secret leiðbeiningar →

Device Code

Notandinn skráir sig inn með eigin aðgangi. Hentar þegar notandi vill tengjast í gegnum sinn BC-aðgang.

Device Code leiðbeiningar →

Client Secret uppsetning

Þetta er bestu leiðin þegar MCP-þjónninn á að keyra sjálfstætt (client credentials) án innskráningar notanda.

1. Skráðu nýtt app í Azure

  1. Opnaðu portal.azure.com → Microsoft Entra ID → App registrations → New registration.
  2. Name: BC Web Service Client eða sambærilegt.
  3. Supported account types: Accounts in this organizational directory only (Single tenant) dugar í flestum tilvikum.
  4. Redirect URI: skildu eftir autt.
  5. Smelltu á Register.

2. API permissions

  1. Farðu í API permissions → Add a permission.
  2. Veldu Dynamics 365 Business Central.
  3. Veldu Application permissions → app_access.
  4. Smelltu á Add permissions.
  5. Smelltu á Grant admin consent for <tenant> og staðfestu.

3. Client secret

  1. Certificates & secrets → Client secrets → New client secret.
  2. Lýsing: t.d. Claude MCP. Gildir: 12–24 mánuðir.
  3. Smelltu á Add. Afritaðu gildið strax — það birtist aldrei aftur.

4. Afritaðu þessi gildi

Farðu svo í BC-skráning hér að neðan.

Device Code uppsetning

Þetta hentar þegar notandi vill tengjast í gegnum sinn eigin BC-aðgang (delegated access). Ekkert client secret þarf.

1. Skráðu nýtt app í Azure

  1. Opnaðu portal.azure.com → Microsoft Entra ID → App registrations → New registration.
  2. Name: BC Claude - Device Code eða sambærilegt.
  3. Supported account types: Accounts in this organizational directory only (Single tenant).
  4. Redirect URI: veldu Public client/native (mobile & desktop) og sláðu inn: 
    https://businesscentral.dynamics.com/OAuthLanding.htm
  5. Smelltu á Register.

2. Leyfa public client flows

  1. Farðu í Authentication flipann.
  2. Neðst, undir Advanced settings: Allow public client flows → Yes.
  3. Smelltu á Save.

3. API permissions

  1. Farðu í API permissions → Add a permission.
  2. Bættu við eftirfarandi Delegated réttindum:

Dynamics 365 Business Central

  • Financials.ReadWrite.All — Delegated (les/skrifa BC gögn).
  • user_impersonation — Delegated (aðgangur sem notandi).

Microsoft Graph (valkvætt)

  • User.Read — Delegated (lesa notandaupplýsingar).
  1. Smelltu á Grant admin consent for <tenant> og staðfestu.

4. Afritaðu þessi gildi

Ekkert client secret þarf — device code flæðið notar offline_access scope við token-beiðni.

Farðu svo í BC-skráning hér að neðan.

BC-hlið — skráðu forritið og veittu réttindi

Þetta skref er eins fyrir bæði Client Secret og Device Code.

  1. Opnaðu Business Central sem admin-notandi.
  2. Leitaðu (Alt+Q) að Microsoft Entra Applications og opnaðu síðuna.
  3. New → fylltu út:
  • Client ID: Application (client) ID frá Azure.
  • Description: stutt lýsing.
  • State: Enabled.
  1. Í User Permission Sets flipanum, bættu við:

Lágmarks réttindi

  • CLOUD EVENTS API — Cloud Events Base / System. Nauðsynlegt.
  • D365 BASIC — Base Application / System. Grunnréttindi.

Gagnareglur (eftir notkun)

  • SUPER (DATA) — fullur aðgangur. Ekki nota fyrir þriðja aðila.
  • Eða afmarkaðar reglur: D365 READ + D365 SALES o.s.frv.
  1. Smelltu á Grant Consent (efst á síðunni).
  2. BC vísar þér á Microsoft — skráðu þig inn sem admin og samþykktu.
Aðskildar skráningar eftir umhverfi Búðu til sérstakt Entra app (og BC Entra Application færslu) fyrir hvert umhverfi — t.d. cronus, prod. Skráðu hvert í Claude með /origo-bc-add-env.

Fyrsta tenging

Opnaðu nýtt spjall og sláðu inn:

/origo-bc-setup

Hjálpin biður um:

  1. MCP URL — https://dynamics.is/api/mcp sjálfgefið.
  2. Tenant ID — Directory (tenant) ID frá Azure.
  3. Client ID — Application (client) ID frá Azure.
  4. Client Secret — gildið sem þú afritaðir (aðeins Client Secret leið).
  5. Environment — Production, Sandbox eða nafn (t.d. cronus).
  6. Company name — eins og það birtist í BC.

Bæta við fleiri umhverfum

/origo-bc-add-env

Skipta um sjálfgefið fyrirtæki

/origo-bc-switch-company

Sýna allt tengt

/origo-bc-list-environments

Úrræðaleit

node: command not found

Node.js er ekki á PATH. Settu upp LTS frá nodejs.org og endurræstu Claude Desktop.

MCP-tólin birtast ekki

Lokaðu Claude Desktop alveg (táknið í kerfisbakka → Quit) og opnaðu aftur. MCP-þjónar sækjast aðeins við ræsingu.

Rangt fyrirtæki í svörum

Keyrðu /origo-bc-switch-company og veldu rétt fyrirtæki.

„Unauthorized“ frá MCP-þjóninum

Auðkenning er útrunnin eða röng. Keyrðu /origo-bc-setup aftur og sláðu inn nýja auðkenningu.

Útgáfur

Nýjasta slóðin er alltaf endurskrifuð við hverja útgáfu. Ef þú vilt festa þig við tiltekna útgáfu, notaðu slóð á borð við:

https://origopublic.blob.core.windows.net/resources/mcp/origo-bc-0.3.0.plugin
https://origopublic.blob.core.windows.net/resources/mcp/origo-bc-0.2.0.plugin

Útgáfunúmerið má finna í plugin.json innan .plugin-skrárinnar.

Aðstoð

Hafðu samband við service@origo.is ef þú finnur villu eða þarft hjálp við tengingu. Viðbótin er opinn hugbúnaður frá Origo hf. og allir notendur Business Central mega nota hana.

What you get

Before you start

Node.js 18 or newer

Both Cowork and Code drive the connection through a small Node process. Check your install: 

node --version

If the command isn't found, grab the LTS build from nodejs.org and restart Claude Desktop afterwards.

Installation

Two ways to install — GitHub Marketplace is recommended and works in both Cowork and Code.

GitHub Marketplace Recommended

Installed via the claude CLI. Works in both Cowork and Code with easy updates.

Marketplace install →

Download .plugin file

Manual download of the .plugin file. Useful if you prefer not to use the CLI or are in Cowork.

Download file →

Option A — GitHub Marketplace (recommended)

You need the claude CLI on your PATH. If you don't have it, install it first:

macOS

# Option A — Homebrew (recommended)
brew install claude

# Option B — npm
npm install -g @anthropic-ai/claude-code

Windows

# npm (requires Node.js 18+)
npm install -g @anthropic-ai/claude-code

Verify the install:

claude --version

Then run two commands:

claude plugin marketplace add businesscentralal/origo-bc-plugin
claude plugin install origo-bc@origo-bc

The first command registers the origo marketplace. The second pulls the latest origo-bc build and installs it into ~/.claude/plugins/. Restart Claude Desktop (or open a new session) so the definitions load.

Works in both modes A plugin installed via the CLI is active in both Cowork and Code — no separate installation per mode needed.

Updating:

claude plugin update origo-bc@origo-bc

To remove: claude plugin uninstall origo-bc

Installing via the Cowork UI

If you're in Cowork, you can also install the plugin directly through the UI — no CLI needed. Here are the steps:

1
Click Customize

In the Cowork sidebar, click Customize.

Cowork sidebar — Customize option
2
Add a plugin

Click the + next to Personal plugins or the Add plugin button.

Customize page — Add plugin button
3
Select Add marketplace

Click Create plugin → Add marketplace.

Create plugin menu — Add marketplace
4
Enter the marketplace URL and click Sync

In the URL field, type: businesscentralal/origo-bc-plugin and click Sync.

Add marketplace dialog — businesscentralal/origo-bc-plugin
5
Verify in the Personal tab

The plugin appears under the Personal tab as Origo bc by Origo hf.

Plugin Directory — Origo bc under Personal
6
Enable automatic sync

Click the … next to the plugin and turn on Sync automatically. This keeps the plugin up to date whenever a new version is published.

Plugin menu — Sync automatically enabled
7
Click Install

Open the plugin and click Install. You'll see 6 skills included.

Origo bc plugin — Install button and 6 skills
8
Run /origo-bc-setup

Open a new chat and type /origo-bc-setup to connect to Business Central.

Option B — Download .plugin file

Download the file in a web browser (Edge, Chrome, Firefox — not inside Claude) and drop it into a Cowork chat.

Download origo-bc.plugin Or pick a pinned version →

Install in Cowork:

  1. Open File Explorer / Finder and go to Downloads.
  2. Open a new Cowork chat alongside it.
  3. Drag origo-bc.plugin directly into the chat input.
  4. Hit Send. Don't cancel.
  5. Claude replies with an install card — click Install.

Or via Settings: Settings → Plugins → Install from file and pick the file.

If no install card appears Check: (1) you're in Cowork mode, not the regular chat; (2) you dropped the file, not a URL; (3) you hit Send instead of cancelling.

Entra App Registration

The MCP server at dynamics.is/api/mcp authenticates against Microsoft Entra (formerly Azure AD). Two authentication methods are supported — choose the one that fits your scenario:

Client Secret

The app runs unattended using client credentials. The MCP server uses app_access application permissions. Best for automated access.

Client Secret setup →

Device Code

The user signs in with their own account. Best when individual users connect via their own BC credentials.

Device Code setup →

Client Secret setup

Use this when the MCP server should run unattended (client credentials flow) without a signed-in user.

1. Register a new app in Azure

  1. Open portal.azure.com → Microsoft Entra ID → App registrations → New registration.
  2. Name: BC Web Service Client or similar.
  3. Supported account types: Accounts in this organizational directory only (Single tenant) works for most setups.
  4. Redirect URI: leave blank.
  5. Click Register.

2. API permissions

  1. Go to API permissions → Add a permission.
  2. Select Dynamics 365 Business Central.
  3. Select Application permissions → app_access.
  4. Click Add permissions.
  5. Click Grant admin consent for <tenant> and confirm.

3. Create a client secret

  1. Certificates & secrets → Client secrets → New client secret.
  2. Description: e.g. Claude MCP. Expires: 12–24 months.
  3. Click Add. Copy the value immediately — it won't be shown again.

4. Copy the values you need

Then proceed to BC-side registration below.

Device Code setup

Use this when individual users should connect using their own BC credentials (delegated access). No client secret is needed.

1. Register a new app in Azure

  1. Open portal.azure.com → Microsoft Entra ID → App registrations → New registration.
  2. Name: BC Claude - Device Code or similar.
  3. Supported account types: Accounts in this organizational directory only (Single tenant).
  4. Redirect URI: pick Public client/native (mobile & desktop) and enter: 
    https://businesscentral.dynamics.com/OAuthLanding.htm
  5. Click Register.

2. Allow public client flows

  1. On the app, open the Authentication tab.
  2. At the bottom, under Advanced settings: Allow public client flows → Yes.
  3. Click Save.

3. API permissions

  1. Go to API permissions → Add a permission.
  2. Add the following Delegated permissions:

Dynamics 365 Business Central

  • Financials.ReadWrite.All — Delegated (read/write BC data).
  • user_impersonation — Delegated (access-as-user).

Microsoft Graph (optional)

  • User.Read — Delegated (read user profile).
  1. Click Grant admin consent for <tenant> and confirm.

4. Copy the values you need

No client secret needed — the device code flow uses the offline_access scope at token time.

Then proceed to BC-side registration below.

BC side — register the app and grant permissions

This step is the same for both Client Secret and Device Code.

  1. Open Business Central signed in as an admin user.
  2. Search (Alt+Q) for Microsoft Entra Applications and open the page.
  3. New → fill in:
  • Client ID: paste the Application (client) ID from Azure.
  • Description: a short name.
  • State: Enabled.
  1. On the User Permission Sets tab, add:

Minimum permissions

  • CLOUD EVENTS API — Cloud Events Base / System. Required.
  • D365 BASIC — Base Application / System. Baseline BC access.

Data permissions (pick based on use)

  • SUPER (DATA) — full access. Don't use for third parties.
  • Or scoped sets: e.g. D365 READ + D365 SALES etc.
  1. Click Grant Consent (top bar).
  2. BC redirects to Microsoft — sign in as a tenant admin and approve.
Separate registrations per environment Create a distinct Entra app (and BC Entra Application record) for each environment — e.g. cronus, prod. Register each in Claude via /origo-bc-add-env.

First connection

Start a fresh chat / session and type:

/origo-bc-setup

The wizard asks for:

  1. MCP URL — https://dynamics.is/api/mcp by default.
  2. Tenant ID — Directory (tenant) ID from Azure.
  3. Client ID — Application (client) ID from Azure.
  4. Client Secret — the value you copied (Client Secret path only).
  5. Environment — Production, Sandbox, or a named sandbox.
  6. Company name — as it appears in BC.

Adding more environments

/origo-bc-add-env

Change the default company

/origo-bc-switch-company

List everything connected

/origo-bc-list-environments

Troubleshooting

node: command not found

Node.js isn't on PATH. Install LTS from nodejs.org and restart Claude Desktop.

MCP tools don't show up

Quit Claude Desktop fully (tray icon → Quit) and relaunch. MCP servers are only loaded at startup.

Wrong company in answers

Run /origo-bc-switch-company and pick the right one.

"Unauthorized" from the MCP server

Credentials expired or were wrong. Run /origo-bc-setup again and paste fresh credentials.

Versions

The latest URL above is overwritten on every release. If you need to pin a specific version, use a URL like:

https://origopublic.blob.core.windows.net/resources/mcp/origo-bc-0.3.0.plugin
https://origopublic.blob.core.windows.net/resources/mcp/origo-bc-0.2.0.plugin

Version numbers live in plugin.json inside the .plugin file — whatever is linked at the top of this page is always the latest release.

Support

Reach service@origo.is if you hit a bug or need help connecting. The plugin is published by Origo hf. and is free for anyone using Business Central.