Manisma
Start free trial
Documentation menu
Docs/EN

Connect your AI assistant

Manisma can connect to an AI assistant you already use, such as Claude Desktop, Claude Code, the ChatGPT desktop app, or the Codex CLI. The connection uses the open Model Context Protocol. You can then ask questions and do planning work in your assistant’s chat window.

Your assistant, your AI

Your own assistant does the thinking. Manisma provides the schedule and the data, but does not run its own AI for this connection. It also does not use the AI actions included in your Manisma plan.

The AI proposal button in Manisma is separate. That feature does use Manisma’s AI and the AI actions in your plan.

What your assistant can do

Your assistant can look up jobs, clients, technicians, materials, task types, and devices. It can create and update jobs and clients, schedule a job with a technician, and request a scheduling proposal. It can never delete anything.

Create a key

Open Admin → API keys, create a key, and copy it immediately. The key is shown only once. Reading, writing, and planning are separate permissions, so a read-only key can look up information but cannot change it. Treat the key like a password.

Install the connection

All routes require Node.js 22 or newer. Check the installed version:

node --version

Get the API key from Admin → API keys. It is shown once and looks like msk_ followed by 40 hexadecimal characters. Reading, writing, and planning are separate scopes.

Route 1: Claude Desktop

  1. Download https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Open the downloaded file. Claude Desktop shows an installation dialog.
  3. Paste the API key when prompted. It is stored securely.

No file editing or terminal is needed.

Route 2: Claude Code

  1. Download https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Open a terminal in the folder containing the download and run:
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
claude mcp add manisma -e MANISMA_API_KEY=msk_your_key_here -- node ~/manisma-mcp/dist/index.js
  1. Replace msk_your_key_here with the API key.
  2. In Claude Code, use the /mcp command to check the connection.

Route 3: Codex CLI and the ChatGPT desktop app

  1. Download https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Open a terminal in the folder containing the download and unpack it:
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
  1. Add this block to ~/.codex/config.toml, replacing the path and key. The path must be absolute because ~ is not expanded in this file.
[mcp_servers.manisma]
command = "node"
args = ["/home/you/manisma-mcp/dist/index.js"]
env = { MANISMA_API_KEY = "msk_your_key_here" }
  1. Run codex mcp list. It should show manisma as enabled.

On Windows, the .mcpb file is a ZIP archive. If Windows does not unpack it, rename the extension to .zip and use Extract All.

What to expect

Your assistant asks before changing anything and handles one job at a time. A scheduling proposal is shown first and is not applied until you confirm it.

The assistant cannot see working hours or days off. Check a proposed time against the real roster. Scheduling proposals are limited to a few requests per ten minutes.

Limitations

The connection works with the data saved in Manisma. It does not replace the planning board and is only as current as what has been saved.

Still have questions about Manisma?

Contact us →