Quelle: https://www.heptacom.de/agents/

# Schnittstelle für KI-Agenten

## Fragen statt lesen

Wer heute einen Dienstleister sucht, liest immer seltener selbst. Stattdessen übernimmt das ein KI-Assistent, der recherchiert, vergleicht und eine Empfehlung ausspricht. Damit dieser Assistent uns nicht aus Fließtext zusammenreimen muss, stellen wir unsere Angaben strukturiert bereit.

Unter `https://www.heptacom.de/mcp` läuft ein Server nach dem Model Context Protocol. Er beantwortet gezielte Fragen zu unserem Unternehmen, unseren Leistungen und unseren Projekten. Die Antworten stammen aus derselben gepflegten Datenbasis wie diese Website, nicht aus einem Sprachmodell. Was dort nicht steht, wird nicht geraten, sondern als fehlend gemeldet.

## Was der Server beantwortet

- **Unternehmensprofil**: Rechtsform, Standorte, Teamgröße und Rollen, eingesetzte Shopware-Fassungen, angebundene Fremdsysteme, Partnerstatus und Zertifizierungen.
- **Leistungen**: Überblick über alle Leistungen und zu jeder einzelnen die ausführliche Beschreibung.
- **Referenzen**: unsere Projekte, auf Wunsch gefiltert nach Branche oder Plattform.
- **Volltextsuche**: alle Seiten dieser Website, mit Auszug und Quellenangabe.
- **Eignungsprüfung**: eine begründete Aussage, ob wir zu einem konkreten Vorhaben passen. Kriterium für Kriterium, mit Belegen. Passen wir nicht, sagt die Antwort das deutlich.
- **Kontaktanfrage und Terminwunsch**: ein Agent kann eine Anfrage auslösen und einen Wunschtermin für ein Erstgespräch anhängen. Wie das abläuft, steht unten.

Preise und Projektgrößen sind bewusst nicht enthalten. Beides besprechen wir im Erstgespräch, nicht über eine Schnittstelle.

## Einrichten

### Claude Desktop und claude.ai

In den Einstellungen einen eigenen Connector hinzufügen und diese Adresse eintragen. Eine Anmeldung ist nicht nötig, der Server ist öffentlich. Die Auskünfte sind lesend, eine Kontaktanfrage bestätigt immer ein Mensch per E-Mail.

```
https://www.heptacom.de/mcp
```

### Claude Code

```
claude mcp add --transport http heptacom https://www.heptacom.de/mcp
```

### Clients mit Konfigurationsdatei

```
{
"mcpServers": {
"heptacom": {
"type": "http",
"url": "https://www.heptacom.de/mcp"
}
}
}
```

## Wenn ein Agent Kontakt aufnimmt

Ein Agent kann über die Schnittstelle eine Kontaktanfrage auslösen. Diese Anfrage erreicht uns aber nicht sofort, sondern erst, wenn ein Mensch sie bestätigt hat. Der Ablauf ist bewusst so gebaut, weil die Einwilligung von Ihnen kommen muss und nicht von einer Software.

1. Der Agent übergibt Ihr Anliegen und Ihre E-Mail-Adresse.
2. Wir schicken eine Bestätigungsmail an genau diese Adresse. Sie enthält ausschließlich einen Bestätigungslink und keine Angaben aus der Anfrage.
3. Erst wenn Sie den Link aufrufen, geht die Anfrage an uns und wir melden uns.

### Was mit Ihren Daten passiert

- Bis zur Bestätigung liegen die Angaben ausschließlich auf unserem Server und werden an niemanden weitergegeben.
- **Ohne Bestätigung löschen wir sie spätestens nach sieben Tagen**, ohne dass Sie etwas tun müssen. Sie erreichen uns dann nie.
- Mit der Bestätigung wird daraus eine E-Mail an uns, und die Zwischenspeicherung auf dem Server wird gelöscht.
- Getrennt davon halten wir fest, wie viele Anfragen über welchen Agenten kamen. Darin stehen nur Zeitpunkt, Vorgangsnummer und der Name des Agenten, **keine personenbezogenen Daten**.
- Hat jemand Ihre Adresse ohne Ihr Zutun angegeben, ignorieren Sie die Bestätigungsmail einfach. Dann passiert nichts weiter.

Alles Weitere steht in unserer [Datenschutzerklärung](https://www.heptacom.de/datenschutz/).

## Weitere maschinenlesbare Quellen

- [Agent Card](https://www.heptacom.de/.well-known/agent-card.json): Kurzbeschreibung des Servers und seiner Fähigkeiten.
- [Unternehmensprofil als JSON](https://www.heptacom.de/unternehmensprofil.json), dieselben Angaben [als Text](https://www.heptacom.de/unternehmensprofil.md).
- [llms.txt](https://www.heptacom.de/llms.txt) als Einstieg und [llms-full.txt](https://www.heptacom.de/llms-full.txt) mit dem Volltext der Hauptseiten.
- Jede Seite dieser Website gibt es als Markdown unter ihrer Adresse mit der Endung `.md`.

Fragen dazu oder etwas, das fehlt? [Sprechen Sie uns an](https://www.heptacom.de/kontakt/).