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

# Connectors erstellen

> Connectors sind OAuth-Integrationen, mit denen deine Base44-App eine Verbindung zu externen Diensten wie Google Calendar, Slack, Notion und weiteren herstellen kann. Nach der Verbindung kannst du Access-Tokens in Backend-Funktionen...

<Warning>
  Diese Seite ist Teil eines KI-Coding-Agent-Skills und für Agenten geschrieben, nicht für Menschen. Für die menschenlesbare Base44-Dokumentation siehe die [Entwicklerdokumentation](/developers).
</Warning>

# Connectors erstellen

Connectors sind OAuth-Integrationen, mit denen deine Base44-App eine Verbindung zu externen Diensten wie Google Calendar, Slack, Notion und weiteren herstellen kann. Nach der Verbindung kannst du Access-Tokens in Backend-Funktionen verwenden, um externe APIs direkt aufzurufen.

## Kernkonzepte

* **Direkter API-Zugriff**: Connectors stellen rohe OAuth-Access-Tokens bereit — du rufst die externen APIs direkt aus Backend-Funktionen auf
* **Konto des App-Builders**: Verbindet dein Konto (das des App-Builders), nicht die Konten deiner Endnutzer
* **Nur Backend-Funktionen**: Aus Sicherheitsgründen sind Tokens nur serverseitig zugänglich

## Dateipfad

Erstelle Connector-Dateien im Verzeichnis `base44/connectors/` (oder im Verzeichnis, das über `connectorsDir` in deiner `config.jsonc` angegeben ist).

**Dateiname:** `{type}.jsonc` oder `{type}.json`

Beispiele:

* `base44/connectors/googlecalendar.jsonc`
* `base44/connectors/slack.jsonc`
* `base44/connectors/notion.json`

## Schema

Jede Connector-Datei muss einen `type` und optional eine Liste von `scopes` angeben:

```jsonc theme={null}
{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events"
  ]
}
```

### Felder

| Feld     | Typ       | Erforderlich | Beschreibung                                                                                     |
| -------- | --------- | ------------ | ------------------------------------------------------------------------------------------------ |
| `type`   | string    | Ja           | Der Integrationstyp (führe `npx base44 connectors list-available` aus, um die Optionen zu sehen) |
| `scopes` | string\[] | Nein         | Anzufragende OAuth-Scopes (Standardwert `[]`)                                                    |

## Verfügbare Connector-Typen entdecken

Führe folgenden Befehl aus, um die aktuelle Liste der unterstützten Connector-Typen zu erhalten. Hinweis: `stripe` ist ebenfalls ein gültiger Typ, wird aber nicht von diesem Befehl zurückgegeben — behandle ihn als unterstützt (siehe Stripe-Beispiel unten).

```bash theme={null}
npx base44 connectors list-available
```

Dies gibt ein JSON-Objekt mit allen verfügbaren Integrationen, ihren Anzeigenamen, Beschreibungen und erforderlichen Verbindungs-Konfigurationsfeldern zurück. Beispielausgabe (gekürzt):

```json theme={null}
{
    "integrations": [
        {
            "integration_type": "googlecalendar",
            "display_name": "Google Calendar",
            "description": "Access and manage Google Calendar events",
            "connection_config_fields": []
        },
        {
            "integration_type": "slack",
            "display_name": "Slack User",
            "description": "Send messages and interact with Slack as yourself (user integration)",
            "connection_config_fields": []
        },
        {
            "integration_type": "share_point",
            "display_name": "SharePoint",
            "description": "Manage documents, lists, sites, and collaboration content in SharePoint",
            "connection_config_fields": [
                {
                    "name": "subdomain",
                    "display_name": "SharePoint Site",
                    "description": "The name of your SharePoint site (e.g., sites/mysite)",
                    "placeholder": "sites/mysite",
                    "required": true,
                    "validation_pattern": "^[a-zA-Z0-9/_-]+$",
                    "validation_error": "Please enter a valid SharePoint site path"
                }
            ]
        }
    ]
}
```

Verwende den Wert `integration_type` aus dieser Ausgabe als Feld `type` in deiner Connector-Datei. Manche Connectors benötigen zusätzliche `connection_config_fields` — prüfe die Ausgabe auf Details.

### Stripe (Sandbox)

```jsonc theme={null}
// base44/connectors/stripe.jsonc
{
  "type": "stripe",
  "scopes": []
}
```

Hinweis: Stripe benötigt keinen OAuth-Browser-Flow. Wenn du diesen Connector pushst, stellt Base44 automatisch serverseitig ein Stripe-Sandbox-Konto bereit. In der Push-Ausgabe erhältst du möglicherweise eine Claim-URL, um die Sandbox mit deinem Stripe-Konto zu verknüpfen.

## Regeln und Einschränkungen

1. **Ein Connector pro Typ**: Du kannst nicht mehrere Connectors desselben Typs haben (z. B. zwei `googlecalendar`-Connectors)

2. **Typ muss gültig sein**: Das Feld `type` muss ein gültiger Integrationstyp sein (führe `npx base44 connectors list-available` aus, um verfügbare Typen zu sehen)

3. **Scopes sind anbieterspezifisch**: Jeder Dienst hat sein eigenes Scope-Format — siehe die Dokumentation des Anbieters

## Nächste Schritte

Nach dem Erstellen von Connector-Dateien pushe sie zu Base44:

```bash theme={null}
npx base44 connectors push
```

Dies fordert dich auf, jeden neuen OAuth-Connector in deinem Browser zu autorisieren. Stripe ist die Ausnahme — es wird automatisch ohne Browser-Flow bereitgestellt. Siehe [connectors-push.md](https://docs.base44.com/developers/skills/base44-cli/references/connectors-push.md) für Details.

Um bestehende Connectors von Base44 in lokale Dateien zu ziehen:

```bash theme={null}
npx base44 connectors pull
```

Siehe [connectors-pull.md](https://docs.base44.com/developers/skills/base44-cli/references/connectors-pull.md) für Details.

<Note>Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die [englische Version](/). </Note>