> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zapbip.com/llms.txt
> Use this file to discover all available pages before exploring further.

# connect_agent

> Verbindet einen neuen Agenten, nachdem der Owner es in WhatsApp erlaubt hat.

Verbindet einen neuen Agenten mit diesem Konto, anhand seines Namens. Der Owner wird in WhatsApp gefragt, als der aufrufende Agent, und der Aufruf wartet auf die Antwort. Er führt denselben Anwendungsfall aus wie der Befehl `neuer agent`, daher gelten dieselben Namensregeln, dasselbe Limit von 8 Agenten und derselbe Installationslink. Siehe [Lass deine KI zapbip verwalten](https://docs.zapbip.com/de/features/let-your-ai-manage-zapbip.md).

## Eingabe

| Feld | Typ | Hinweise |
| - | - | - |
| `name` | string | Vereinfacht wie beim Befehl: Kleinbuchstaben, keine Akzente, Bindestriche statt Leerzeichen, bis zu 20 Zeichen. |

## Die Frage

Drei Buttons: **Allow**, **Allow, send to agent** und **Deny**, mit einer kurzen Referenz am Ende der Frage. Der Aufruf wartet bis zu 50 Sekunden. Nur die Antwort per Button zählt: Eingetippter Text wird als Deny gelesen. Deny und Schweigen ändern nichts, und eine Antwort nach der Wartezeit ändert ebenfalls nichts; dieselbe Anfrage wird dann 10 Minuten lang abgelehnt (`cooling_down`).

## Ausgabe

`{ "status": "applied" | "denied" | "timed_out" | "refused", "agent": string | null, "reason": string | null, "install_prompt": string | null }`.

* `applied`: Der Agent wurde verbunden. Nach **Allow** ging der Installationslink in WhatsApp an den Owner, und `install_prompt` ist `null`. Nach **Allow, send to agent** enthält `install_prompt` die zwei Zeilen zum Einfügen in den neuen Agenten. Nur so gelangt ein Link oder Schlüssel in ein Werkzeugergebnis.
* `denied` und `timed_out`: Nichts hat sich geändert.
* `refused`: `reason` ist `invalid_name`, `reserved_name`, `name_taken`, `limit_reached`, `cooling_down`, `window_closed`, `send_failed`, `suspended` oder `waitlisted`. Ein ungültiger oder reservierter Name wird abgelehnt, bevor der Owner gefragt wird. Kann der Link nicht gesendet werden, wird die neue Verbindung wieder widerrufen.

Höchstens 3 handelnde Aufrufe (`connect_agent`, [revoke\_agent](https://docs.zapbip.com/de/mcp-reference/revoke-agent.md) und [sign\_in\_link](https://docs.zapbip.com/de/mcp-reference/sign-in-link.md)) pro Minute und Verbindung; der nächste ist ein Fehler, der mit `rate_limited` beginnt.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.