# Tools · Ansässige Unternehmen

> MCP-Tools für ansässige Unternehmen (Coworking): Unternehmen auflisten, anlegen, bearbeiten und abschließen, dein Unternehmen, das Team, per E-Mail einladen, den Unternehmens-Admin markieren und entfernen.

Die [ansässigen Unternehmen](/membros/empresas-residentes) mit dem Assistenten: das Unternehmen mit Vertrag anlegen, 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**.

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_resident_companies`](#list-resident-companies) | Die Unternehmen, mit Art, Status und Teamgröße | Moderator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_resident_company`](#get-resident-company) | Ein Unternehmen | Moderator oder Finanzen | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`get_my_resident_company`](#get-my-resident-company) | Das Unternehmen, in dem du bist, mit dem Team | Alle | <span class="tool-kind tool-kind-read">Nur lesen</span> |
| [`create_resident_company`](#create-resident-company) | Legt ein Unternehmen mit Vertrag an | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`update_resident_company`](#update-resident-company) | Ändert Namen und Vertrag | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`close_resident_company`](#close-resident-company) | Beendet die Residenz, mit oder ohne Team | Administrator | <span class="tool-kind tool-kind-confirm">Mit Bestätigung</span> |
| [`list_resident_company_members`](#list-resident-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_resident_company_member`](#invite-resident-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_resident_company_member`](#update-resident-company-member) | Markiert den Unternehmens-Admin oder nimmt die Markierung zurück | Administrator | <span class="tool-kind tool-kind-write">Ändert</span> |
| [`remove_resident_company_member`](#remove-resident-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_resident_company_invitations`](#list-resident-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_resident_company`, `list_resident_company_members`, `invite_resident_company_member`, `remove_resident_company_member`, `list_resident_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 Vertrag bleibt bei der Verwaltung.** Monatlicher Betrag und Daten gehen an Eigentümer, Administrator und Finanzen; der Moderator liest die Unternehmen ohne diese Felder, und `get_my_resident_company` liefert sie nie. Der monatliche Betrag ist nur ein Eintrag, ohne Abrechnung.

**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_resident_companies`

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

**Die ansässigen Unternehmen**, nach Namen, mit Art der Nutzung, Status (`active`, oder `ended`, wenn abgeschlossen oder der 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 Vertrag (monatlicher Betrag, Beginn, Auszug und Abschlussdatum); der Moderator nicht. *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 ansässig?“*

## `get_resident_company`

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

**Ein Unternehmen.** Mit Vertrag für Eigentümer, Administrator und Finanzen. Unternehmen einer anderen Community: „nicht gefunden“. Der Admin eines Unternehmens nutzt `get_my_resident_company`. *Mindestrolle: Moderator (oder Finanzen).*

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

**Frag so:** *„Bis wann läuft der Vertrag von Acme?“*

## `get_my_resident_company`

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

**Dein Unternehmen.** Das Unternehmen, in dem die verbundene Person ist (ohne Vertrag), ob sie Unternehmens-Admin ist, das Team und `canManageTeam`, wahr für den Admin eines aktiven Unternehmens (falsch nach dem Abschluss). Ohne Unternehmen kommt `company: null` zurück; offene Einladungen stehen in `list_my_company_invitations`. *Mindestrolle: alle.*

Keine Parameter.

**Frag so:** *„Wer ist in meinem Unternehmen?“*

## `create_resident_company`

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

**Ein Unternehmen anlegen**, mit Vertrag. Das Unternehmen bekommt keinen Login; Personen kommen mit `invite_resident_company_member` dazu. *Mindestrolle: Administrator (Eigentümer oder Administrator).*

| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| `name` | Text | Ja | Der Name, bis 120 Zeichen |
| `residence_type` | `PRIVATE_OFFICE`, `FIXED_DESK` oder `VIRTUAL_OFFICE` | Ja | Privates Büro, fester Arbeitsplatz oder virtuelles Büro |
| `monthly_value` | Zahl | Ja | Der monatliche Betrag, null oder mehr. Nur als Eintrag, ohne Abrechnung |
| `starts_at` | JJJJ-MM-TT | Ja | Der Vertragsbeginn |
| `ends_at` | JJJJ-MM-TT | Nein | Der geplante Auszug, nicht vor dem Beginn |

**Frag so:** *„Lege Acme Tecnologia an, privates Büro, R$ 4.800 im Monat, seit 1.11.“*

## `update_resident_company`

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

**Bearbeiten.** Nur, was du schickst: Name, Art, Betrag, Beginn oder Auszug (`ends_at: null` löscht den Auszug). Zum sofortigen Abschließen nutze `close_resident_company`. *Mindestrolle: Administrator (Eigentümer oder Administrator).*

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

**Frag so:** *„Acme zieht am 31.12. aus. Aktualisiere den Vertrag.“*

## `close_resident_company`

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

**Die Residenz jetzt beenden.** Das Unternehmen nimmt keine Einladungen mehr an; Eintrag und Vertrag 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_resident_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_resident_companies` oder `get_my_resident_company`) |

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

## `invite_resident_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_resident_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 |
| `profile_id` | ID | Ja | Die Person (aus `list_resident_company_members`) |
| `is_admin` | wahr/falsch | Ja | Wahr markiert; falsch nimmt zurück |

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

## `remove_resident_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 |
| `profile_id` | ID | Ja | Die Person (aus `list_resident_company_members`) |

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

## `list_resident_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 anlegen (`create_resident_company`), die Person einladen, die sich darum kümmert (`invite_resident_company_member`), und sie als Unternehmens-Admin markieren (`update_resident_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_resident_company_member`) und verfolgt das in `list_resident_company_invitations`; die eingeladene Person sieht die Einladung (`list_my_company_invitations`) und nimmt sie an (`accept_company_invitation`).

## Verwandt

- [Ansässige Unternehmen](/membros/empresas-residentes)
- [Tools](/mcp/ferramentas)
- [Tools · Mitglieder](/mcp/ferramentas-membros)
- [Geld und Bestätigung](/mcp/dinheiro-e-confirmacao)
- [Rezepte](/mcp/receitas)