# Tools · Unternehmen

> MCP-Tools für Unternehmen (mit optionalem Coworking-Block, den Angeboten und den Rechnungsdaten): Unternehmen auflisten, anlegen, bearbeiten und abschließen, dein Unternehmen mit Abonnements und Credits, das Team, per E-Mail einladen, den Unternehmens-Admin markieren und entfernen.

Die [Unternehmen](/membros/empresas) mit dem Assistenten: das Unternehmen anlegen (und im Coworking Art, die Pläne und Produkte, die es buchen kann, die Rechnungsdaten und die Daten), bearbeiten, abschließen, dein Unternehmen sehen, das Team, per E-Mail einladen, Einladungen verfolgen, annehmen und ablehnen, den Unternehmens-Admin markieren und entfernen. Es sind **14 Tools**.

> [!NOTE]
> Bis zum 2026-10-18 hießen diese Tools `*_resident_company*` (zum Beispiel `get_my_resident_company`). Die alten Namen gibt es nicht mehr: Ein Assistent, der sie noch aufruft, bekommt „unbekanntes Tool“ und sollte die Namen dieser Seite verwenden.

Jedes Tool hat ein Abzeichen: <span class="tool-kind tool-kind-read">Nur lesen</span> ändert nichts, <span class="tool-kind tool-kind-write">Ändert</span> legt sofort etwas an oder ändert es, und <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao).

## Auf einen Blick

| Tool | Was es tut | Mindestrolle | Art |
|---|---|---|---|
| [`list_companies`](#list-companies) | Die Unternehmen, mit Art, Status und Teamgröße | Moderator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_company`](#get-company) | Ein Unternehmen | Moderator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_my_company`](#get-my-company) | Das Unternehmen, in dem du bist, mit dem Team und dem, was du darüber hast | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`create_company`](#create-company) | Legt ein Unternehmen an, mit optionalem Coworking-Block | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_company`](#update-company) | Ändert Namen und Coworking-Block | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`close_company`](#close-company) | Schließt das Unternehmen ab, mit oder ohne Team | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`list_company_members`](#list-company-members) | Das Team eines Unternehmens | Alle (die API prüft die Zugehörigkeit) | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`invite_company_member`](#invite-company-member) | Nimmt jemanden per E-Mail ins Team auf | Alle (die API prüft die Zugehörigkeit) | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_company_member`](#update-company-member) | Markiert den Unternehmens-Admin oder nimmt die Markierung zurück | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`remove_company_member`](#remove-company-member) | Nimmt jemanden aus dem Team | Alle (die API prüft die Zugehörigkeit) | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`list_company_invitations`](#list-company-invitations) | Die offenen Einladungen des Unternehmens-Admins | Alle (die API prüft die Zugehörigkeit) | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`list_my_company_invitations`](#list-my-company-invitations) | Deine Unternehmenseinladungen | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`accept_company_invitation`](#accept-company-invitation) | Nimmt deine Einladung an und tritt dem Team bei | Alle (die eigene Einladung) | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`decline_company_invitation`](#decline-company-invitation) | Lehnt deine Einladung endgültig ab | Alle (die eigene Einladung) | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |

Die Rollen sind die der Routen: Der Assistent tut nie mehr, als die verbundene Person auf dem Bildschirm tun könnte. Eigentümer und Administrator sehen alle 14; Moderator und Finanzen 10 (die zwei Lese-Tools des Community-Teams und die acht, die jeder Rolle offenstehen); das Mitglied 8 (`get_my_company`, `list_company_members`, `invite_company_member`, `remove_company_member`, `list_company_invitations`, `list_my_company_invitations`, `accept_company_invitation` und `decline_company_invitation`).

**Acht Tools erscheinen für jede Rolle**, weil der Admin eines Unternehmens meist ein normales Mitglied ist und jede Person eine Einladung bekommen kann. Die API entscheidet nach der Zugehörigkeit: Das Team lesen nur das Community-Team oder die Leute des eigenen Unternehmens, und einladen und entfernen dürfen nur Eigentümer, Administrator oder der Admin dieses Unternehmens (solange es aktiv ist). Alle anderen erhalten „keine Berechtigung“.

**Die Einladung des Unternehmens-Admins hängt von der Annahme ab.** Sie verbindet nie sofort, auch nicht, wer schon in der Community ist: Die Person erhält die Einladung per E-Mail und kommt erst ins Team, wenn sie annimmt (`accept_company_invitation`). Eigentümer und Administrator der Community verbinden weiterhin direkt.

**Der Coworking-Block bleibt bei der Verwaltung.** Art der Nutzung, Daten, Angebote (`offers`), Rechnungsdaten (`billing`) und der Kauflink (`purchaseLink`) gehen an Eigentümer, Administrator und Finanzen; der Moderator erfährt nur, ob das Unternehmen Coworking hat (`coworking`). `get_my_company` liefert die Angebote und den Link an das ganze Team, die Abrechnung nur an den Unternehmens-Admin.

**Das Unternehmen abonniert und zahlt, aber nicht über den Assistenten.** Angebote und Rechnungsdaten einzutragen kostet nichts. Kaufen tut der Unternehmens-Admin, in der App, über den `purchaseLink` (der Assistent nimmt nie eine Karte an): Der Assistent gibt den Link weiter. Danach kümmert sich der Unternehmens-Admin mit den Tools unter [Abonnements](/mcp/ferramentas-assinaturas) um die Abrechnung (`list_my_subscriptions` und `list_my_purchases` mit `company_id`, `pay_my_subscription_now`, `quote_my_add_on` und `add_my_add_on`, `quote_plan_change` und `change_my_plan`, `manage_my_subscription`), per PIX oder Boleto, und liest das Credit-Guthaben unter [Credits](/mcp/ferramentas-creditos) (`get_company_credit_balance`, `list_company_credit_entries`).

**Wer das Team verlässt, wird nicht mehr abgerechnet.** Beim Entfernen oder beim Abschließen mit Team weist die Zusammenfassung darauf hin, dass die Abrechnung für die entfernte Person ausgesetzt wird; das Abo bleibt erfasst, bis es gekündigt wird, was unter [Abonnements](/mcp/ferramentas-assinaturas) geht.

## `list_companies`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Die Unternehmen**, nach Namen, mit `coworking` (ob der Coworking-Block eingeschaltet ist), Status (`active`, oder `ended`, wenn abgeschlossen oder der geplante Auszug vorbei ist) und wie viele Personen im Team sind. Unternehmen sind keine Mitglieder und erscheinen nie in Mitgliederlisten. Eigentümer, Administrator und Finanzen erhalten auch den Block (Art der Nutzung, Beginn und Auszug), das Abschlussdatum, die Angebote, die Rechnungsdaten und den `purchaseLink`, alles leer bei ausgeschaltetem Coworking; der Moderator erhält nur `coworking`. *Mindestrolle: Moderator (oder Finanzen).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `status` | `active` oder `ended` | Nein | Filtert nach Status |
| `search` | Text | Nein | Teil des Namens |

**Frag so:** *„Welche Unternehmen sind heute aktiv?“*

## `get_company`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Ein Unternehmen.** Mit Coworking-Block, Angeboten, Rechnungsdaten und `purchaseLink` für Eigentümer, Administrator und Finanzen, die auch die Abonnements des Unternehmens (`subscriptions`) und den Stand des Credit-Guthabens (`credit_balance`) erhalten; die Käufe des Unternehmens stehen in `list_purchases` (`buyer.companyId`). Der Moderator erhält nur `coworking`. Unternehmen einer anderen Community: „nicht gefunden“. Der Admin eines Unternehmens nutzt `get_my_company`. *Mindestrolle: Moderator (oder Finanzen).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `company_id` | ID | Ja | Das Unternehmen (aus `list_companies`) |

**Frag so:** *„Ist Acme mit dem Plan auf dem Laufenden? Wie viele Credits hat das Unternehmen?“*

## `get_my_company`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Dein Unternehmen.** Das Unternehmen, in dem die verbundene Person ist ob sie Unternehmens-Admin ist, das Team und `canManageTeam`, wahr für den Admin eines aktiven Unternehmens (falsch nach dem Abschluss), dazu die Angebote, `canPurchase` und `purchaseLink`. Für **jede Person im Team** eines aktiven Unternehmens liefert es `benefits`: was sie über das Unternehmen hat, ohne Preise. In `items` die aktiven Pläne und Produkte des Unternehmens (aktives Abonnement oder aktiver Kauf: `title`, `isPlan`, `kind`, `source`, `plan`) mit den `spaces` und `contents`, die jedes freischaltet; in `credits` der Stand des Guthabens (`balance`) und der nächste Verfall (`expiringSoon`). Bei einem abgeschlossenen Unternehmen ist `benefits` `null`. Für den Unternehmens-Admin auch die Rechnungsdaten (`billing`), die Abonnements (`subscriptions`, mit der offenen Verlängerung), die Käufe (`purchases`) und den Credit-Stand (`credit_balance`); bei einem überfälligen Abonnement ist der vorgeschlagene nächste Schritt `pay_my_subscription_now`. Ohne Unternehmen kommt `company: null` zurück; offene Einladungen stehen in `list_my_company_invitations`. *Mindestrolle: alle.*

Keine Parameter.

**Frag so:** *„Was habe ich über mein Unternehmen?“* · *„Wer ist in meinem Unternehmen?“* · *„Ist das Abonnement meines Unternehmens bezahlt?“*

## `create_company`

<span class="tool-kind tool-kind-write">Ändert</span>

**Ein Unternehmen anlegen.** Nur der Name ist Pflicht: Ohne die Coworking-Felder ist das Unternehmen nur Name und Team. Im Coworking-Block listet `offer_product_ids` die Pläne und Produkte, die das Unternehmen buchen kann (nur digitale Produkte), und `billing` die Rechnungsdaten. Hier wird nichts abgerechnet und nicht nach Bestätigung gefragt: Die Antwort enthält den `purchaseLink`, die Seite, auf der der Unternehmens-Admin bucht, und der Assistent gibt den Link weiter. Produkt einer anderen Community: „nicht gefunden“; Produkt, das nicht digital ist: abgelehnt. Das Unternehmen bekommt keinen Login; Personen kommen mit `invite_company_member` dazu. Mit `parcel_notice_admins_only` erhalten nur die Admins des Unternehmens den Hinweis auf ein [Paket](/espacos/encomendas#pakete-fur-ein-unternehmen) (Voreinstellung: alle Mitarbeitenden mit Zugriff auf den Bereich). *Mindestrolle: Administrator (Eigentümer oder Administrator).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `name` | Text | Ja | Der Name, bis 120 Zeichen |
| `coworking` | wahr/falsch | Nein | Schaltet den Coworking-Block ein oder aus. Weggelassen, schaltet er sich ein, sobald ein Feld des Blocks ausgefüllt ist |
| `residence_type` | `PRIVATE_OFFICE`, `FIXED_DESK` oder `VIRTUAL_OFFICE` | Nein | Privates Büro, fester Arbeitsplatz oder virtuelles Büro |
| `offer_product_ids` | Liste von IDs, bis 20 | Nein | Die digitalen Pläne und Produkte, die das Unternehmen buchen kann (aus `list_plans` oder `list_products`) |
| `billing` | `legal_name`, `tax_id` (CNPJ), `email` | Nein | Die Rechnungsdaten; jedes Feld optional, `null` löscht es |
| `starts_at` | JJJJ-MM-TT | Nein | Der Beginn im Coworking |
| `ends_at` | JJJJ-MM-TT | Nein | Der geplante Auszug, nicht vor dem Beginn |
| `parcel_notice_admins_only` | wahr/falsch | Nein | Nur die Admins des Unternehmens erhalten den Paket-Hinweis (Voreinstellung: falsch) |

**Frag so:** *„Lege Acme Tecnologia im Coworking an, privates Büro, seit 1.11., mit dem Plan Privates Büro monatlich zum Buchen. Firmenname Acme Tecnologia Ltda, Rechnungs-E-Mail financeiro@memberfy.net.“* · *„Lege das Unternehmen Steuerbüro Silva an.“*

## `update_company`

<span class="tool-kind tool-kind-write">Ändert</span>

**Bearbeiten.** Nur, was du schickst: Name, `coworking`, Art, Angebote, Rechnungsdaten, Beginn oder Auszug. Die gesendete Liste `offer_product_ids` ersetzt die vorherige (`[]` oder `null` leert sie). `null` löscht ein Feld des Blocks; ein ausgefülltes Feld schaltet Coworking ein; `coworking: false` schaltet es aus und löscht den ganzen Block. Zum sofortigen Abschließen nutze `close_company`. *Mindestrolle: Administrator (Eigentümer oder Administrator).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `company_id` | ID | Ja | Das Unternehmen |
| `name`, `coworking`, `residence_type`, `offer_product_ids`, `billing`, `starts_at`, `ends_at`, `parcel_notice_admins_only` | verschiedene | Nein | Nur, was sich ändert |

**Frag so:** *„Acme zieht am 31.12. aus. Aktualisiere den geplanten Auszug.“* · *„Bei Acme nur die Admins informieren, wenn ein Paket ankommt.“*

## `close_company`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**Das Unternehmen jetzt abschließen.** Das Unternehmen nimmt keine Einladungen mehr an, gibt dem Team keinen Zugang mehr und wird nicht mehr abgerechnet; Eintrag und Coworking-Block bleiben gespeichert. Es gibt kein Wiedereröffnen. Mit `remove_members` (Standard: wahr) verlassen alle das Team, und wer über das Unternehmen in die Community kam und noch Mitglied ist, verlässt auch die Community. Die Zusammenfassung nennt, wer geht, und weist darauf hin, dass ihre Abrechnung ausgesetzt wird und das Abo erfasst bleibt, bis es gekündigt wird. Schon abgeschlossenes Unternehmen: abgelehnt. Der erste Aufruf liefert die Zusammenfassung und den Bestätigungscode. *Mindestrolle: Administrator (Eigentümer oder Administrator).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `company_id` | ID | Ja | Das Unternehmen |
| `remove_members` | wahr/falsch | Nein | Standard: wahr. Falsch lässt das Team mit dem abgeschlossenen Unternehmen verbunden |

**Frag so:** *„Schließe Acme ab und nimm das Team heraus.“*

## `list_company_members`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Das Team eines Unternehmens**, Admins zuerst: Name, Position, ob Unternehmens-Admin, ob über das Unternehmen beigetreten und, für das Community-Team und den Unternehmens-Admin, die E-Mail. Lesen dürfen das Community-Team oder die Leute des eigenen Unternehmens. *Mindestrolle: alle (die API prüft die Zugehörigkeit).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `company_id` | ID | Ja | Das Unternehmen (aus `list_companies` oder `get_my_company`) |

**Frag so:** *„Zeig mir das Team von Acme.“*

## `invite_company_member`

<span class="tool-kind tool-kind-write">Ändert</span>

**Per E-Mail ins Team aufnehmen.** Durch **Eigentümer oder Administrator** verbindet es sofort: Wer schon in der Community ist, bekommt nur die Verbindung, ohne E-Mail (`linked`); alle anderen kommen als Mitglied in die Community und **erhalten die Einladung per E-Mail** (`invited`): Der Assistent sagt das vorher. Durch den **Unternehmens-Admin** verbindet es nie: Die Antwort ist immer `invited` mit `pending: true` und der `invitation_id`, egal wer die Person ist, und der Assistent sagt *„Einladung gesendet. Die Person kommt ins Team, sobald sie annimmt.“*, ohne zu behaupten, ob sie schon in der Community war. Abgelehnt, wenn die Community keine neuen Mitglieder aufnimmt, die Person nicht teilnehmen möchte, schon in diesem Team ist oder das Unternehmen abgeschlossen ist; bei Eigentümer und Administrator auch, wenn sie schon in einem anderen Unternehmen ist. Einladen dürfen Eigentümer, Administrator und der Admin dieses Unternehmens (solange es aktiv ist); `is_admin` nur Eigentümer und Administrator. Der Unternehmens-Admin verschickt bis zu 30 Einladungen pro Stunde (darüber 429 mit `Retry-After`); Eigentümer und Administrator haben kein solches Limit. *Mindestrolle: alle (die API prüft die Zugehörigkeit).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `company_id` | ID | Ja | Das Unternehmen |
| `email` | Text | Ja | Die E-Mail der Person |
| `name` | Text | Nein | Der Name, falls das Konto jetzt angelegt wird |
| `is_admin` | wahr/falsch | Nein | Kommt gleich als Unternehmens-Admin dazu (Eigentümer oder Administrator) |

**Frag so:** *„Lade joao@memberfy.net ins Team meines Unternehmens ein.“*

## `update_company_member`

<span class="tool-kind tool-kind-write">Ändert</span>

**Den Unternehmens-Admin markieren oder die Markierung zurücknehmen.** Der Unternehmens-Admin lädt sein eigenes Team ein und entfernt es. *Mindestrolle: Administrator (Eigentümer oder Administrator).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `company_id` | ID | Ja | Das Unternehmen |
| `member_id` | ID | Ja | Die Person (aus `list_company_members`) |
| `is_admin` | wahr/falsch | Ja | Wahr markiert; falsch nimmt zurück |

**Frag so:** *„Mach Maria zur Admin von Acme.“*

## `remove_company_member`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**Jemanden aus dem Team nehmen.** Kam die Person über das Unternehmen in die Community und ist noch Mitglied, verlässt sie auch die Community und verliert den Zugang; war sie schon in der Community, verliert sie nur die Verbindung. Die Zusammenfassung sagt, welcher Fall vorliegt, und weist darauf hin, dass die Abrechnung für die entfernte Person ausgesetzt wird und das Abo erfasst bleibt, bis es gekündigt wird. Entfernen dürfen Eigentümer, Administrator und der Admin dieses Unternehmens (solange es aktiv ist). Der erste Aufruf liefert die Zusammenfassung und den Bestätigungscode. *Mindestrolle: alle (die API prüft die Zugehörigkeit).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `company_id` | ID | Ja | Das Unternehmen |
| `member_id` | ID | Ja | Die Person (aus `list_company_members`) |

**Frag so:** *„Nimm João aus dem Team von Acme; er hat das Unternehmen verlassen.“*

## `list_company_invitations`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Die offenen Einladungen des Unternehmens**: die der Unternehmens-Admin geschickt hat und auf die noch niemand geantwortet hat, die neuesten zuerst, mit der eingegebenen E-Mail und dem Datum. Sie sagt nie, wer die Person ist oder ob sie schon in der Community war. Einladungen von Eigentümer und Administrator verbinden sofort und erscheinen hier nicht. Lesen dürfen das Community-Team und der Admin dieses Unternehmens, solange es aktiv ist. *Mindestrolle: alle (die API prüft die Zugehörigkeit).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `company_id` | ID | Ja | Das Unternehmen |

**Frag so:** *„Wen habe ich in mein Unternehmen eingeladen, der noch nicht angenommen hat?“*

## `list_my_company_invitations`

<span class="tool-kind tool-kind-read">Nur lesen</span>

**Deine Einladungen.** Die offenen Einladungen der verbundenen Person in ein Team (*„du wurdest in das Unternehmen X eingeladen“*), die neuesten zuerst, mit Unternehmen, einladender Person und Datum. Nur aktive Unternehmen dieser Community; ohne Einladungen eine leere Liste. *Mindestrolle: alle.*

Keine Parameter.

**Frag so:** *„Habe ich eine Unternehmenseinladung?“*

## `accept_company_invitation`

<span class="tool-kind tool-kind-write">Ändert</span>

**Deine Einladung annehmen.** Die Person kommt ins Team (nicht als Unternehmens-Admin). Ohne Bestätigung. Einladung einer anderen Person, schon beantwortet oder aus einer anderen Community: „nicht gefunden“. Unternehmen nach der Einladung abgeschlossen oder Person schon im Team eines anderen Unternehmens: abgelehnt, mit der Meldung der API. *Mindestrolle: alle (die eigene Einladung).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `invitation_id` | ID | Ja | Die Einladung (aus `list_my_company_invitations`) |

**Frag so:** *„Nimm die Einladung von Acme an.“*

## `decline_company_invitation`

<span class="tool-kind tool-kind-confirm">Mit Bestätigung</span>

**Deine Einladung ablehnen.** Es entsteht keine Verbindung, und die Einladung ist endgültig weg: Um später beizutreten, braucht es eine neue Einladung. Der erste Aufruf liefert die Zusammenfassung und den Bestätigungscode. *Mindestrolle: alle (die eigene Einladung).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `invitation_id` | ID | Ja | Die Einladung (aus `list_my_company_invitations`) |

**Frag so:** *„Lehne die Einladung von Acme ab.“*

## Vorgeschlagene Rezepte

- **Ein Unternehmen anlegen:** das Unternehmen mit den Angeboten anlegen (`create_company`), den `purchaseLink` weitergeben, die Person einladen, die sich darum kümmert (`invite_company_member`), und sie als Unternehmens-Admin markieren (`update_company_member`, oder `is_admin` gleich in der Einladung).
- **Der Admin lädt ein, die Person nimmt an:** Der Unternehmens-Admin lädt die Kollegin oder den Kollegen ein (`invite_company_member`) und verfolgt das in `list_company_invitations`; die eingeladene Person sieht die Einladung (`list_my_company_invitations`) und nimmt sie an (`accept_company_invitation`).
- **Was ich über das Unternehmen habe:** Jede Person im Team fragt, und der Assistent antwortet mit `benefits` aus `get_my_company` (Pläne, Inhalte und Credits des Unternehmens, ohne Preise).

## Verwandt

- [Unternehmen](/membros/empresas)
- [Tools](/mcp/ferramentas)
- [Tools · Mitglieder](/mcp/ferramentas-membros)
- [Werkzeuge · Abonnements](/mcp/ferramentas-assinaturas)
- [Werkzeuge · Credits](/mcp/ferramentas-creditos)
- [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao)
- [Rezepte](/mcp/receitas)