Page History

Overview

The iDNA Applications Companion is an AI-assistant plugin for HCL Notes/Domino estate analysis: usage, modernization, source-code remediation and application lifecycle. It adds a curated knowledge wiki and analysis guidance to your AI client and, once connected to the MCP server of your iDNA Applications appliance, answers from your live iDNA data.

...

• The plugin: the knowledge wiki, the "idna-wikilookup" skill and the Companion's operating instructions. The plugin also works on its own. : without a connection to iDNA. It , it answers from the wiki only (restricted wiki mode) and says so.
  It is installed from panagenda's plugin marketplace on GitHub:
  • https://github.com/panagenda/idna-companion
• The MCP connection: connects the AI client to your iDNA appliance for live data. It requires that your iDNA administrator has enabled the MCP server (see Setting up the MCP Server in iDNA Applications).

Supported Clients

Not supported: claude.ai Chat, and the Chat mode of the Claude desktop app. The Companion needs its plugin files next to its skill, and they are not available there. In the Claude desktop app, use Cowork or Code.

Limited support: Microsoft Copilot Desktop app. Copilot does not support local MCP connections at the time of releasing iDNA 3.5.0. To retain partly plugin capabilitykeep part of the plugin's capabilities, place the plugin files in the user's OneDrive. Copilot will index indexes them and have the capability to can then answer questions regarding about iDNA content /and dashboards and support SQL query creation. help write SQL queries. The plugin files are the folder plugins/idna-companion in the release archive (see Machines Without Access to github.com, step 1).

Prerequisites

• Client: one of the supported clients, installed and signed in.
• Installation source: access to github.com, or an offline copy of the plugin (see Machines Without Access to github.com).
• License: installing or using the plugin is subject to its license, which is part of the plugin and of the repository on GitHub.
• For live data:
  • the MCP server is enabled on your iDNA appliance (iDNA Applications 3.5.0 or later),
  • your iDNA user has the MCP role (ask your iDNA administrator),
  • your machine reaches the appliance over HTTPS (through VPN where applicable),
  • a personal MCP token (see the next section).

...

Note: create one token per machine or client, so that each can be revoked on its own. The clients store the token in plain text, in their configuration or, for OpenAI ChatGPT/Codex, in an environment variable; treat it like a password and do not share it.

Claude Cowork

...

(Desktop App)

Install the Plugin

1. In the Claude desktop app, open Cowork and select [Customize].
   Note: install the plugin here, not in the Code tab. Plugins installed through Customize are available in Cowork and Code; plugins installed in the Code tab are available in Code only.
2. Go to [Plugins] and select [+ Add] → [Add marketplace].
   
3. Enter https://github.com/panagenda/idna-companion, select it and confirm with [Sync].
   
4. The marketplace now lists the iDNA Applications Companion. Click [Add] to install it.
   

...

1. Install Node.js from https://nodejs.org/en/download/ if it is not installed yet. To check, run npm -v in a command prompt.
2. Install mcp-remote:

   Code Block
   language bash
   npm install -g mcp-remote

   To check, run mcp-remote test. The command ends with an error like code: 'ERR_INVALID_URL', input: 'test', which is expected: it shows that mcp-remote is installed.
3. Open the configuration: on Windows, the menu (three horizontal bars at the top left) → [File] → [Settings] → [Developer] → [Edit Config]; on macOS, [Claude] → [Settings] → [Developer] → [Edit Config]. This opens the file claude_desktop_config.json (or the folder that contains it); open the file in a text editor.

   Note
   title Screenshot needed
   Claude desktop app, Settings → Developer, with the [Edit Config] button marked. No MCP server entries with real host names or tokens visible.

4. Exit Claude completely before you edit the file: closing the window is not enough. On Windows, right-click the Claude icon in the notification area of the taskbar and select [Exit]; on macOS, quit Claude.
   
5. Add the iDNA Applications entry under "mcpServers". If the file already contains other settings, keep them and add only the "iDNA Applications" block; if there is no "mcpServers" section yet, add it. Make sure the file remains valid JSON (commas, braces).

   Code Block
   language javascript
   { "mcpServers": { "iDNA Applications": { "command": "mcp-remote", "args": [ "https://<your iDNA host>/mcp", "--header", "Authorization: Bearer <your token>" ] } } }

6. Save the file and start Claude again. In [Settings] → [Developer], the "iDNA Applications" server is now listed as running.

   Note
   title Screenshot needed
   Claude desktop app, Settings → Developer: the "iDNA Applications" server with the status "running", the command mcp-remote and its arguments, with the host replaced by an example host and the token blurred.

...

Claude Code CLI

Install the Plugin

claude plugin marketplace add panagenda/idna-companion
claude plugin install idna-companion@panagenda

...

• The Companion says that live iDNA tools are unavailable and answers in restricted wiki mode. The session has no working MCP connection. Possible causes: the MCP entry is missing on this machine, the token has expired or was revoked, there is no network path to the appliance (VPN), or the client did not load the tools for this session (start a new session).
• The server is listed but fails to connect. Check that the address ends in /mcp and that the token is still valid in [MCP Tokens]. An expired or revoked token is rejected; create a new one and update the client's configuration.
• Claude desktop app: the server does not start. Check that Node.js and mcp-remote are installed (see above), and that Claude was exited completely before the configuration was edited. The logs are in %APPDATA%\Claude\logs\ (files mcp*.log) on Windows; [Settings] → [Developer] also offers [View logs].
• OpenAI ChatGPT/Codex or Codex CLI: the server fails to connect after the token was set or replaced. The app and the CLI read IDNA_MCP_TOKEN only when they start: restart the app or open a new terminal. Check that the name of the variable matches exactly.
• GitHub Copilot App on Windows: uninstalling or updating fails with "access denied". The App installs plugin files read-only and can fail to remove them. Clear the flag in PowerShell, then retry:

  Code Block
  language powershell
  attrib -R /S /D "$env:USERPROFILE\.copilot\installed-plugins\*"

...