minimusdocs
Help center

Minimus tools for AI apps

Connect an AI app to your panel and ask it, in your own words, to look things up or make changes.

Your panel has a built-in MCP server: the standard way AI apps reach outside tools. Connect an app to it once, and the app gets the Minimus tools — find a line, extend it, restart a stream, check a server — and uses them when you ask.

"Which of my lines expire this week?" · "Extend alice by one month with the Monthly package." · "Stream Channel A keeps buffering: check its sources and restart it."

The app acts as your account, never beyond it, limited to the scopes you approve, and every call it makes is in the panel's call log.

Your panel's MCP address

https://panel.example.com/mcp

Use your own panel's address instead of panel.example.com: the one from its install. The dashboard's AI apps page shows it ready to copy under Your MCP address, with the steps for each app below it.

The MCP server answers on the panel's own address only: not on a reseller's own domain, and not on the panel's rescue address. Apps that run on the web (ChatGPT, Claude) reach it from their own servers, so your panel needs a public HTTPS address for them.

Two ways to connect

Sign in (web and desktop apps)

Apps such as ChatGPT and Claude connect by signing in, with no key to copy:

  1. You add the MCP address in the app.
  2. The app opens your panel's sign-in page. You sign in as the account it should act for.
  3. The panel shows the app's name, where it will send you back, and what it may do. Untick what it should not do, then Approve (or Deny).
  4. The app is connected. It appears under AI apps in the dashboard's menu, where you can Disconnect it at any time.

An app renews its access on its own, without asking you again. One not used for 30 days must be approved again (the panel's owner can change both in Settings → Panel settings → AI apps).

API key (tools on your computer)

Tools that run on your computer or a server — Claude Code, Codex, Gemini CLI, Cursor, VS Code — can also sign in, but an API key is often simpler:

  1. Make an API key with the scopes the tool needs.
  2. Put it in an environment variable, such as MINIMUS_API_KEY.
  3. Point the tool at the MCP address and tell it to send Authorization: Bearer with the key.

Revoking the key disconnects the tool.

Set up your app

ChatGPT

Add Minimus as a connector, sign in, approve.

Claude and Claude Desktop

Add a custom connector, sign in, approve.

Claude Code

One claude mcp add command.

Codex

Three lines in config.toml.

Gemini CLI

One entry in settings.json.

Cursor

One entry in mcp.json.

VS Code

One entry in .vscode/mcp.json.

Any other app

Apps that only start local tools, through mcp-remote.

Good habits

  • Approve the smallest scopes that do the job. read lets an app answer questions without being able to change anything.
  • Read before you confirm. AI apps can misunderstand. Most ask before running a tool that changes something: read what it is about to do, especially anything that deletes or moves credits.
  • Use a separate account for an app that others use, with only the permissions it needs. See Accounts and permissions.
  • Disconnect apps you no longer use in AI apps.