Doku · Agenten

Verbinden Sie Ihren KI-Agenten.

Ihr Agent arbeitet in AgencyOS mit einem eigenen Token und erreicht nur, was Sie erlauben. Zum Verbinden braucht er eine Adresse und dieses Token. Installieren müssen Sie nichts.

Was ein Agent kann – und was nicht.

Ein Agent handelt unter eigenem Namen, alles, was er schreibt, ist also als seine Arbeit erkennbar. Er erreicht genau die Projekte, die sein Token nennt, und nie mehr.

Er kann

Das Board lesen und Aufgaben anlegen, ändern und verschieben
Aufgaben kommentieren sowie Dateien anhängen und lesen
Den Feed lesen und darin posten
Dokumente lesen und schreiben und sie mit Aufgaben verknüpfen
Kunden, Projekte, Spalten und Labels anlegen, sofern sein Token nicht auf Projekte beschränkt ist

Er kann nie

Personen, Einladungen, andere Tokens oder Zeiteinträge erreichen
Eine Datei entfernen oder die Kommentar-Diskussion eines anderen abschließen
Entscheiden, was ein Kunde sieht – es sei denn, Sie erlauben es auf dem Token
Eine Seite per öffentlichem Link teilen oder sehen, wer sie gelesen hat
Seinen eigenen Zugriff auf irgendeine Weise erweitern

Drei Schritte.

Ein Inhaber erstellt das Token. Danach kann es jeder in die Einstellungen des Agenten einfügen.

01
Token erstellen
Öffnen Sie als Inhaber Einstellungen → Agenten-Tokens → Neues Token. Benennen Sie es nach dem Agenten, wählen Sie eine Laufzeit und lassen Sie die Projekte leer für vollen Zugriff – oder wählen Sie die aus, in denen er arbeiten darf. Das Token wird nur einmal angezeigt, kopieren Sie es also sofort.
02
AgencyOS beim Agenten eintragen
Geben Sie Ihrem Agenten die Adresse unten und senden Sie das Token im Authorization-Header. Jeder MCP-Client, der Streamable HTTP spricht und einen Header setzen lässt, kann sich verbinden.
https://api.agencyoshq.de/mcp
03
Fragen, was er sieht
Fragen Sie etwa: „Worauf hast du in AgencyOS Zugriff?“ Der Agent prüft sein Token und nennt Ihren Workspace, seine Rolle und seine Projekte. Wenn das klappt, klappt auch alles andere.

Einrichtung in Ihrem Client.

Ersetzen Sie aos_… durch Ihr Token. Halten Sie es aus allem heraus, was Sie committen oder teilen: Wer es besitzt, handelt als der Agent.

Claude Code, im Terminal

claude mcp add --transport http agencyos \
  https://api.agencyoshq.de/mcp \
  --header "Authorization: Bearer aos_…"

Claude Code, in .mcp.json

{
  "mcpServers": {
    "agencyos": {
      "type": "http",
      "url": "https://api.agencyoshq.de/mcp",
      "headers": {
        "Authorization": "Bearer ${AGENCYOS_TOKEN}"
      }
    }
  }
}

Diese Datei wird üblicherweise committet, deshalb liest sie das Token aus der Umgebungsvariable AGENCYOS_TOKEN, statt es zu enthalten. Setzen Sie diese Variable auf Ihrem eigenen Rechner.

Jeder andere Client

Transport: Streamable HTTP
Adresse: https://api.agencyoshq.de/mcp
Header: Authorization: Bearer aos_…

Gut zu wissen.

Die Regeln, unter denen ein Agent arbeitet – damit mitten in einer Aufgabe nichts überrascht.

Dateien reisen in der Nachricht

Ein Agent übergibt eine Datei als Text oder als Base64, bis 20 MB. Die Verbindung hat keinen Zugriff auf den Rechner, auf dem der Agent läuft, und kann eine Datei daher nicht über ihren Pfad holen.

Beschränkte Tokens bleiben in ihren Projekten

Ein auf bestimmte Projekte beschränktes Token arbeitet nur in diesen. Kunden oder Projekte kann es nicht anlegen, denn was es anlegt, läge außerhalb seiner eigenen Reichweite.

Sichtbarkeit entscheiden Sie

Sofern Sie es auf dem Token nicht erlauben, übernimmt alles, was ein Agent anlegt, die Voreinstellung des Projekts, und der Agent kann nicht ändern, wer was sieht.

Ein großzügiges Ratenlimit

Bis zu 600 Anfragen pro Minute. Ein großer Import bleibt weit darunter; ein Agent, der in einer Schleife hängt, wird gebremst, bevor er jemanden stört.

Jederzeit widerrufbar

Ein widerrufenes Token wirkt schon bei der nächsten Anfrage nicht mehr. Was der Agent geschrieben hat, bleibt – unter seinem Namen.

Nur für Programme

Die Adresse antwortet MCP-Clients, nie einer Webseite. Eine Anfrage aus dem Browser wird abgelehnt, auch mit gültigem Token.

Wenn etwas abgelehnt wird.

Meldungen von AgencyOS erreichen Ihren Agenten wörtlich, und jede sagt, was als Nächstes zu tun ist. Die Meldungen sind englisch; diese begegnen Ihnen am ehesten:

Meldung	Was zu tun ist
`The MCP endpoint takes an agent token: send Authorization: Bearer aos_… — an owner creates one under Settings → Agent tokens.`	Es wurde kein Token gesendet. Prüfen Sie den Authorization-Header und dass er mit „Bearer “ beginnt.
`That token is not valid`	Das Token ist vertippt oder hat nie existiert. Kopieren Sie es erneut oder erstellen Sie ein neues.
`That token has expiredThat token has been revoked`	Das Token ist abgelaufen oder widerrufen. Bitten Sie einen Inhaber um ein neues.
`Your own access is scoped to projects, so you cannot create this`	Das Token ist auf Projekte beschränkt. Arbeiten Sie in diesen oder bitten Sie einen Inhaber um ein Token ohne Beschränkung.
`This token may not decide who sees things. Leave visibility out and the project’s default applies; an owner can allow it on the token.`	Der Inhaber hat diesem Token nicht erlaubt, über Sichtbarkeit zu entscheiden. Lassen Sie das Feld weg, dann gilt die Voreinstellung.
`The MCP endpoint does not answer browsers`	Die Anfrage kam aus einem Browser. Verbinden Sie sich stattdessen über einen MCP-Client.

Sie nutzen AgencyOS noch nicht?

Wir richten Ihren Workspace gemeinsam mit Ihnen ein – und Ihr Agent kann helfen, Ihre laufenden Projekte zu übernehmen.

Jetzt starten Zu den Funktionen