Docs
ENDE
Sign in

Connect your AI

Open in Grafaris

Grafaris works through your own AI. You connect it once. From then on your AI can read and change your board.

A connector is the link that lets your AI talk to Grafaris. You need a paid AI plan that allows your own connectors. For Claude that is Pro, Max, Team or Enterprise. For ChatGPT that is Plus, Pro, Business, Enterprise or Edu. Grafaris also works with DeutschlandGPT and Grok.

Open the setup

  1. Click your picture at the top right, then Preferences.
  2. Open Connected agents and click Set up an AI.
  3. Under Which AI do you use?, click your AI.
  4. Click the Connect button with its name.

The setup page shows every step with pictures. Keep it open while you work in your AI. It notices when you are done. Below are the same steps for the Claude app.

Claude app (easiest, about two minutes)

Part 1: connect Grafaris.

  1. Open the Claude app on your computer.
  2. Click Customize on the left, then Connectors at the top.
  3. Click + Add at the top right, then Add custom connector.
  4. Type Grafaris as the name. Paste this address, then click Continue:
https://mcp.grafaris.com/mcp
  1. Click Add at the bottom. Leave the settings as they are.
  2. Click Connect. Your web browser opens. Click Continue connecting.
  3. On the Grafaris page, pick your organisation and project, then click Allow.

Part 2: add the Grafaris skills. Skills teach your AI the Grafaris jobs, such as doing your comments.

  1. In Claude, click Customize on the left, then Plugins at the top.
  2. Click + Add at the top right, then Add marketplace.
  3. Click Add from a repository. Paste this address into the URL box:
https://gitlab.com/grafaris-public/grafaris-skills.git
  1. Click the Use row under the box, then Sync. The window closes without a message. That is fine.
  2. A list of plugins appears. Click Add next to Grafaris.

Part 3: check it.

  1. In Claude, click New at the top left.
  2. Paste this sentence and press Enter:
Check my Grafaris setup

Claude answers whether everything works. The setup page in Grafaris moves on by itself once Claude has answered. If Claude reports a problem, see "It worked before and stopped" below.

ChatGPT

ChatGPT gets the Grafaris tools, but not the skills. It can do your comments and make presentations. It cannot screenshot your app or build code. The setup page shows the ChatGPT steps with pictures. To check the connection, send this:

Call the Grafaris doctor tool

Claude Code, Codex or Grok in a terminal

This part is for people who use a terminal, the window where you type commands. Skip it if you don't.

On the setup page, pick Advanced: terminal. It shows the commands for each AI. For Claude Code, run these three lines in a terminal, not in a chat:

claude plugin marketplace add https://gitlab.com/grafaris-public/grafaris-skills.git
claude plugin install grafaris@grafaris
claude mcp add --transport http --scope user grafaris https://mcp.grafaris.com/mcp

Then restart Claude Code and type /mcp. Pick grafaris and sign in when your browser opens.

It worked before and stopped

Click Connect my local AI in the left bar. It opens a short checklist. Or paste this into your AI. The doctor tool is the Grafaris check that finds what is wrong:

Call the Grafaris doctor tool and follow what it says.

To take access away from an AI, open Preferences › Connected agents.