Rial-Soft plugin marketplace

This repository distributes the portal-onec plugin to Codex, Claude Code, and the Chat tab in Claude Desktop. One installation adds two shared production MCP connections and their skills:

• Portal 1C / onec_portal for Portal tasks and employee activity statistics;
• 1C Business / onec_business for business reads and explicitly authorized mutations in the /ka information base.

Each MCP resource has an independent OAuth/PKCE grant. Users sign in with their own 1C account only for the connections they need. The repository contains no 1C passwords, JWTs, cookies, OAuth credentials, client secrets, certificates, or production signing keys.

Подробная русскоязычная инструкция: INSTALL_RU.md.

Install in Codex and Claude Code

git clone https://git.rial-soft.ru/aleks/portal-onec-marketplace.git
Set-Location portal-onec-marketplace
Set-ExecutionPolicy -Scope Process Bypass
.\Install-PortalOnecPlugin.ps1 -Target All

If Codex Desktop is installed but the separate codex command is missing, opt in to installing the official npm CLI:

.\Install-PortalOnecPlugin.ps1 -Target Codex -InstallCodexCliIfMissing

The installer does not use the protected internal executable from the Microsoft Store app. The optional switch runs npm install -g @openai/codex and then uses the generated user-level CLI wrapper.

On Windows, the installer detects the standard Git Bash location required by Claude Code and sets CLAUDE_CODE_GIT_BASH_PATH only for the installer process.

Use -Target Codex or -Target Claude to install only one host. -StartCodexAuthentication asks Codex CLI to open OAuth for onec_portal and then onec_business; without it, use Settings → MCP servers. Claude Code authenticates each connection from /mcp.

Install in Claude Desktop Chat

1. Download releases/portal-onec-claude-desktop.zip without unpacking it.
2. In Claude Desktop open Customize → Plugins and upload the ZIP.
3. Open Customize → Connectors and connect Portal 1C and/or 1C Business.
4. Complete the separate browser OAuth flow for each selected connector.
5. Enable the needed connector in a conversation through + → Connectors.

Do not add these remote servers to claude_desktop_config.json; that file is for the separate local-MCP mechanism. For Team or Enterprise, an Owner can upload the same ZIP to the organization marketplace once, while every member retains an individual OAuth grant.

Update

git pull --ff-only
.\Install-PortalOnecPlugin.ps1 -Target All

Start a new Codex task or Claude Code session after updating plugin files. Do not clear existing OAuth credentials: each server refreshes its own short-lived access token through a rotating refresh family.

Publisher workflow

The canonical plugin source is D:\Projects\Portal\plugins\portal-onec. Rebuild this marketplace from the Portal workspace with:

powershell.exe -ExecutionPolicy Bypass -File D:\Projects\Portal\scripts\Build-PortalOnecMarketplace.ps1

Validate both hosts before publishing. Bump the shared plugin version whenever the installed package changes.