MCP-Integration

Wenn Sie eine KI wie Claude Code, Codex, ChatGPT, Cursor oder Claude Desktop mit Addness verbinden (MCP-Integration), kann die KI Ihre Ziele, ToDos, Kommentare und mehr in Addness lesen und schreiben.

Für Einsteiger: Bei Personen, die eine neue Organisation erstellt haben, und bei Personen, die per Einladung einer Organisation beigetreten sind, enthält die Zielseite „Addness einrichten". Drücken Sie darin in der Zeile „1. Verbinde deine KI mit Addness" auf „AI fragen" → „In Claude Code öffnen" (oder „In Codex öffnen"), und die KI geht der Reihe nach vor, beginnend mit der Verbindung zu Addness (→ Zielseite). Die Schritte ab der Installation der KI-App finden Sie unter KI-App installieren und mit Addness verbinden. Dieser Artikel erklärt nur den Teil zur MCP-Integration.

Die Anfrage an die KI senden

Senden Sie einfach diese Anfrage an die KI, die Sie nutzen.

Bitte richten Sie Addness MCP (https://vt.api.addness.com/mcp) ein.

Die KI erledigt, was sie kann, und führt Sie nur dort, wo Ihre Handlung erforderlich ist. Nur die Anmeldebestätigung im Browser nehmen Sie bitte selbst vor, wenn die KI Sie dazu auffordert.

Was die KI dadurch tun kann

Egal, von welcher KI aus Sie sich verbinden: Sie liest und schreibt denselben Zielbaum derselben Organisation.

Wenn es unterwegs stoppt: Schritte nach Tool

Wenn die Einrichtung bei Berechtigungen oder der Authentifizierung stoppt, zeigen Sie der KI die folgenden Schritte oder fahren Sie selbst fort.

ChatGPT (offizielles Plugin)

Geben Sie in ChatGPT „@Addness“ ein oder wählen Sie Addness aus der App-Liste. Wählen Sie „Verbinden“, melden Sie sich bei Addness an und wählen Sie „Erlauben“. Verfügbar im Free-Tarif. Schreibvorgänge müssen bestätigt werden. Verbinden können Sie nur ein bestehendes Addness-Konto (über ChatGPT ist keine Neuregistrierung möglich).

Claude Code (Terminal)

1. Addness MCP hinzufügen (mit --scope user, damit es aus jedem Projekt nutzbar ist)

claude mcp add --transport http --scope user addness https://vt.api.addness.com/mcp

1. Bei Addness anmelden (wenn der Browser sich öffnet, mit Ihrem Addness-Konto bestätigen)

claude mcp login addness

1. Die Verbindung prüfen (fertig, wenn addness in der Liste erscheint; Sie können es auch über /mcp innerhalb von Claude Code prüfen)

claude mcp list

Codex (CLI)

Sie können es nutzen, indem Sie sich einfach im Browser bei Addness anmelden. Das Erstellen eines API-Schlüssels ist nicht nötig (das alte Codex unterstützt OAuth nicht, aktualisieren Sie es daher vor der Ausführung auf die neueste Version).

1. Addness MCP hinzufügen (der Browser öffnet sich automatisch, bestätigen Sie also mit Ihrem Addness-Konto. Die Einstellungen werden in ~/.codex/config.toml gespeichert)

codex mcp add addness --url https://vt.api.addness.com/mcp

1. Die Verbindung prüfen (fertig, wenn Auth OAuth ist. Falls die Anmeldung nicht startet, führen Sie codex mcp login addness aus)

codex mcp list

Cursor

1. Öffnen Sie ~/.cursor/mcp.json und fügen Sie die folgende Einstellung hinzu (wenn Sie andere Server haben, fügen Sie nur den Eintrag addness hinzu)

{
  "mcpServers": {
    "addness": {
      "url": "https://vt.api.addness.com/mcp"
    }
  }
}

1. Drücken Sie in Cursors Settings → Tools & MCP auf Connect für addness und bestätigen Sie im Browser mit Ihrem Addness-Konto

Claude Desktop

Fügen Sie ein Remote-MCP nicht über eine Konfigurationsdatei hinzu, sondern als benutzerdefinierten Connector.

1. Öffnen Sie Customize → Connectors und wählen Sie + → Add custom connector
2. Setzen Sie den Namen auf Addness und die URL auf https://vt.api.addness.com/mcp und speichern Sie (bei Team / Enterprise ist eine Organisationskonfiguration durch den Owner erforderlich)
3. Drücken Sie Connect für Addness und bestätigen Sie im Browser (Sie können es pro Unterhaltung über Connectors aktivieren)

Weitere MCP-kompatible Clients

Jeder MCP-Client, der Streamable HTTP und OAuth unterstützt, kann sich verbinden.

1. Setzen Sie den Servernamen auf addness und den Transport auf Streamable HTTP
2. Geben Sie https://vt.api.addness.com/mcp als Verbindungsziel an
3. Melden Sie sich über die Authentifizierungsschaltfläche des Clients bei Addness an; fertig, sobald die Tool-Liste abgerufen ist

Prüfen, ob die Verbindung steht

Bitten Sie Ihre KI: „Zeig mir die Liste meiner Organisationen in Addness". Wenn sie mit den Namen der Organisationen antwortet, denen Sie angehören, steht die Verbindung. Sie können auch „Zeig mir meine ToDos in Addness" sagen und prüfen, ob Ihre ToDos zurückkommen.

Wenn Sie mehreren Organisationen angehören, bitten Sie die KI vor Beginn der Arbeit: „Wechsle in Addness zur Organisation 〈Name der Organisation〉". Die KI wechselt die Organisation, in der sie arbeitet (switch_organization). Ist sie bereits mit dieser Organisation verbunden, bleibt alles, wie es ist. Die gewechselte Organisation gilt auch in den nächsten Unterhaltungen mit derselben KI.

Wenn die KI antwortet, dass es keine Addness-Tools gibt oder dass eine Authentifizierung nötig ist, lesen Sie Wenn keine Verbindung zustande kommt.

Zum Übergeben vom Bildschirm: „AI fragen"

Anstatt mit Worten zu bitten, können Sie es auch über das ✦ („AI fragen") rechts in der Zeile eines Ziels übergeben (bei Mobil-Breite über das „…" der Zeile → „AI fragen").

• Voranbringen: Die KI liest den Kontext dieses Ziels und bringt es direkt voran
• Ideen sammeln: Die KI ordnet die Dinge im Gespräch mit Ihnen und schlägt Unterziele vor. Nur die, die Sie bestätigen, werden erstellt
• Fragen: Schreiben Sie auf, was Sie wissen möchten, und übergeben Sie es – die KI liest das Ziel und antwortet. Das Ziel wird dabei nicht verändert

Wenn Sie „In Claude Code öffnen", „In Codex öffnen" oder „In ChatGPT öffnen" drücken, öffnet sich die KI mit einer Anweisung, die die URL des Ziels und die Vorgehensweise enthält. Mit „Anweisung kopieren" können Sie sie in eine andere KI wie Cursor einfügen und nutzen. Wenn Sie in den persönlichen Einstellungen unter „AI" das „Ziel der Anweisung" festlegen, öffnet sie sich mit einem Klick, ohne dass Sie jedes Mal wählen. Eine ausführliche Erläuterung, was passiert, finden Sie auf der Zielseite.

Unterschied zur API für externe Integrationen

Mit der MCP-Integration liest und schreibt Ihre KI in Addness unter Ihrem eigenen angemeldeten Konto. Wenn Ihre eigenen Systeme nur die Mitglieder und heutigen To-dos Ihrer Organisation lesen sollen, verwenden Sie die API für externe Integrationen (nur Lesen), die mit einem an die Organisation gebundenen Schlüssel aufgerufen wird. Schlüssel für externe Integrationen funktionieren nicht mit MCP. Die API steht nur Organisationen zur Verfügung, für die Addness sie freigeschaltet hat.

Wenn keine Verbindung zustande kommt

Hier finden Sie häufige Probleme und wie Sie sie beheben. Wie Sie die KI-App installieren und verbinden, steht unter KI-App installieren und mit Addness verbinden.

Die Addness-Tools lassen sich nicht nutzen

• Sie haben die KI verbunden, aber sie sagt, es gibt keine Addness-Tools: Am Computer in Claude Code oder Codex Direkt nach dem Verbinden sind die Tools erst zu sehen, wenn Sie die KI-App neu öffnen. Beenden Sie die App, öffnen Sie sie erneut, wählen Sie dieselbe Unterhaltung aus und senden Sie „weiter". Das Schließen des Fensters beendet die App nicht. Auf dem Mac beenden Sie sie mit Command + Q. Unter Windows schließen Sie sie mit Alt + F4. Ist das Symbol danach noch unten rechts auf dem Bildschirm zu sehen, klicken Sie mit der rechten Maustaste darauf und wählen Sie „Beenden". Im Terminal drücken Sie zweimal Ctrl + C, um zu beenden, und kehren mit claude --resume (bei Codex codex resume) zur selben Unterhaltung zurück
• Auch nach dem Neuöffnen sagt die KI, es gibt keine: Claude Code lädt die Addness-Tools manchmal erst, wenn es sie verwendet. Sagen Sie der KI: „Such die Addness-Tools und verwende sie"
• Bei jedem Tool fragt die KI nach einer Erlaubnis und hält an: Bitten Sie die KI: „Stell es so ein, dass du die Addness-Tools nutzen kannst, ohne mich jedes Mal zu fragen". In Claude Code wird dann mcp__addness in die Liste der Erlaubnisse in der Einstellungsdatei (~/.claude/settings.json) eingetragen
• Sie hatten die Addness-Tools entfernt, um Kontext freizumachen: Solange sie entfernt sind, kann die KI weder Ihre Ziele noch Ihre To-dos in Addness lesen. Lassen Sie sie verbunden, solange Sie mit Addness arbeiten. Wenn Sie sie entfernt haben, bitten Sie die KI: „Aktiviere die Addness-Tools wieder", und öffnen Sie die App neu
• Addness wird in Claude oder ChatGPT im Browser nicht angezeigt: Verbinden Sie Addness in ChatGPT über das offizielle Plugin oder in Claude im Browser über einen benutzerdefinierten Konnektor. Siehe Addness nur auf dem Smartphone verwenden.

Die Anmeldung geht nicht weiter oder die Verbindung bricht ab

• Der Anmeldebildschirm öffnet sich nicht: Bitten Sie die KI: „Starte die Anmeldung bei Addness und zeig mir die URL". Fügen Sie die angezeigte URL in den Browser ein, öffnen Sie sie und drücken Sie auf „Zulassen". Wenn der Bildschirm mit „Zulassen" nicht erscheint oder sich ein anderer Browser öffnet, lesen Sie „Wenn es nicht klappt" in KI-App installieren und mit Addness verbinden
• Sie haben auf „Zulassen" gedrückt, aber es kommt ein Fehler: Wenn der Anmeldebildschirm längere Zeit offen bleibt, erscheint ein Fehler wie „Der Autorisierungscode konnte nicht generiert werden." Lassen Sie die KI die Anmeldung noch einmal starten und drücken Sie auf dem Bildschirm, der sich öffnet, sofort auf „Zulassen"
• Früher hat es funktioniert, jetzt ist eine Anmeldung nötig oder wird immer wieder verlangt: Die Verbindung zu Addness läuft nach 90 Tagen ab. In folgenden Fällen wird sie schon früher getrennt. Wenn Sie sich aus derselben KI-App neu verbinden, wird die vorherige Verbindung dieser App getrennt. Pro Person sind bis zu 20 Verbindungen möglich; darüber hinaus wird zuerst die Verbindung getrennt, die am längsten nicht genutzt wurde (wer mehrere Computer oder KIs nutzt, kann dadurch alte Verbindungen verlieren). Bitten Sie die KI: „Melde dich erneut bei Addness an", und drücken Sie im Browser auf „Zulassen"
• Sie haben das Firmenkonto und das private Konto verwechselt: Die KI verbindet sich mit dem Konto, das auf dem Bildschirm „Mit Addness MCP verbinden" bei „Angemeldet als …" steht. Prüfen Sie die E-Mail-Adresse, bevor Sie auf „Zulassen" drücken. Wenn Sie das falsche Konto verbunden haben, melden Sie sich im Browser mit dem richtigen Konto neu bei Addness an und bitten Sie danach die KI: „Melde dich erneut bei Addness an"

Die KI ist mit einer anderen Organisation verbunden

• Die KI sagt „nicht gefunden", oder sie liest Ziele einer anderen Organisation: Die KI verbindet sich mit der Organisation, die Sie in Addness im Browser ausgewählt hatten, als Sie auf „Zulassen" gedrückt haben. Wenn Sie mehreren Organisationen angehören, bitten Sie die KI: „Wechsle in Addness zur Organisation 〈Name der Organisation〉". Auch wenn Sie der KI die URL eines Ziels geben, wechseln Sie zuerst zu der Organisation, in der das Ziel liegt

Unter Windows bleibt es hängen

• Das Verbinden mit Codex oder Anfragen vom Smartphone bleiben hängen: Wenn nur die Codex-App installiert ist, lässt sich der Befehl codex auf dem Computer manchmal nicht verwenden. Unter Windows war das in einigen Fällen die Ursache. Bitten Sie die KI: „Prüfe, ob der Befehl codex funktioniert, und installiere ihn, falls nicht". Wenn sich Codex nicht öffnet, obwohl Sie auf „In Codex öffnen" drücken, drücken Sie auf „Anweisung kopieren", fügen Sie die Anweisung in Codex ein und senden Sie sie ab
• In Codex für Windows wird die Anmeldung bei Addness nicht fertig: Aktualisieren Sie Codex auf die neueste Version und melden Sie sich erneut an. Wenn sie dann immer noch nicht fertig wird, können Sie sich auch mit Claude Code verbinden

<a id="mobile-only"></a>

Addness nur auf dem Smartphone verwenden

• ChatGPT-App: Geben Sie in ChatGPT „@Addness“ ein oder wählen Sie Addness aus der App-Liste. Tippen Sie auf „Verbinden“, melden Sie sich bei Addness an und tippen Sie auf „Erlauben“.
• Claude-App: Öffnen Sie in Safari claude.ai → Anpassen → Konnektoren → ＋Hinzufügen → Benutzerdefinierten Konnektor hinzufügen → Name Addness und URL https://vt.api.addness.com/mcp → Verbinden und erlauben. Aktivieren Sie Addness in der Claude-App, fügen Sie die Anweisungen ein und senden Sie sie.
• Am Computer fortfahren: Folgen Sie Anfragen vom Smartphone kommen nicht an, um Aufgaben an die KI auf Ihrem Computer zu senden.

<a id="phone-pc-relay"></a>

Anfragen vom Smartphone kommen nicht an

„Anfragen vom Smartphone kommen nicht an“ beschreibt, wie Sie Aufgaben an die KI auf einem Computer senden. Wenn Sie nur ein Smartphone verwenden, lesen Sie „Addness nur auf dem Smartphone verwenden“.

„AI fragen" in der Addness-App auf dem Smartphone schickt Ihre Anfrage an Claude Code oder Codex auf Ihrem Computer. Dafür muss die Addness-Desktop-App (→ Web-App und Desktop-App) auf dem Computer installiert und geöffnet sein, angemeldet mit demselben Addness-Konto, und der Computer muss wach sein. Öffnen Sie außerdem auf dem Smartphone und in der Desktop-App dieselbe Organisation. Diese Vorbereitung übernimmt die KI, wenn Sie ihr auf dem Computer das Ziel „Beauftrage deine KI vom Handy aus" übergeben. Auf einem Windows-Computer der Firma lässt sich die Desktop-App manchmal nicht ausführen.

• „Die KI auf deinem Computer ist noch nicht verbunden" erscheint: Die Vorbereitung auf dem Computer ist noch nicht abgeschlossen. Öffnen Sie Addness auf dem Computer, drücken Sie bei „Beauftrage deine KI vom Handy aus" auf „AI fragen" (✦) und gehen Sie die Schritte durch
• „Startet, wenn der PC aufwacht" bleibt stehen, und nichts passiert: Der Computer ist im Ruhezustand, oder die Desktop-App ist geschlossen. Wecken Sie den Computer auf und öffnen Sie die App, dann startet die Anfrage. Nach 24 Stunden wird die Anfrage abgebrochen
• „Codex wurde auf dem PC nicht gefunden" erscheint: Der Befehl codex ist auf Ihrem Computer nicht installiert. Bitten Sie die KI auf dem Computer: „Installiere den Befehl codex", und öffnen Sie danach die Desktop-App neu
• Sie nutzen das Codex, das in der ChatGPT-App auf dem Mac enthalten ist: Die Desktop-App findet das Codex in der ChatGPT-App nicht. Bitten Sie die KI auf dem Computer: „Installiere den Befehl codex", und öffnen Sie danach die Desktop-App neu (die Desktop-App sucht Codex nur in .local/bin in Ihrem Benutzerordner und an den Orten, an denen das Terminal nach Befehlen sucht)
• „Wähle in Addness auf dem PC einen Arbeitsordner" oder „In Addness auf dem PC ist kein Arbeitsordner gewählt" erscheint: Öffnen Sie in den Einstellungen der Desktop-App auf Ihrem Computer „リモート操作" (Fernsteuerung) und wählen Sie ganz oben unter „作業フォルダ" (Arbeitsordner) den Ordner, in dem die KI arbeiten soll. Bis dahin erreichen Anfragen weder Claude Code noch Codex
• „Aktualisiere Addness auf dem PC" erscheint: Die Desktop-App auf Ihrem Computer ist veraltet. Aktualisieren Sie sie auf die neueste Version und senden Sie erneut
• „In Addness auf dem PC ist bei Codex „Vom Smartphone annehmen" ausgeschaltet" erscheint: Öffnen Sie in den Einstellungen der Desktop-App auf Ihrem Computer „リモート操作" (Fernsteuerung) und aktivieren Sie im Abschnitt „Codex" die Option „スマホから受け付ける" (Vom Smartphone annehmen) (wählen Sie vorher einen „作業フォルダ" (Arbeitsordner))
• Die Anfrage kommt nicht bei Claude Code an: Prüfen Sie, ob Sie in der Claude-App auf dem Smartphone mit demselben Claude-Konto angemeldet sind wie auf dem Computer

Es kommt immer noch keine Verbindung zustande

• Mit keinem der Schritte kommt eine Verbindung zustande: Möglicherweise blockiert eine Antivirensoftware oder das Firmennetzwerk die Verbindung zu Addness. In einigen Fällen kam die Verbindung zustande, nachdem vt.api.addness.com in den Einstellungen der Software von der Prüfung ausgenommen wurde. Auf einem Firmencomputer wenden Sie sich an Ihre IT-Abteilung
• Auch damit kommen Sie nicht weiter: Machen Sie einen Screenshot des Bildschirms, an dem es hängt, und wenden Sie sich über „Fragen zu Addness" auf der Hilfe-Startseite an uns