# MCP Server Anbindung

# MCP Server Anbindung

## Microsoft Azure

### App-Registrierung #1

URL: [https://portal.azure.com/#home](https://portal.azure.com/#home) aufrufen.

1. App-Registrierungen anklicken
2. Auf "Neue Registrierung" klicken.

<div drawio-diagram="2325"><img src="https://wiki.dedesales.de/uploads/images/drawio/2026-06/NKkCQz9icqKLyder-drawing-8-1780315123.png" alt="NKkCQz9icqKLyder-drawing-8-1780315123.png"/></div>

#### Name

Bitte verwenden Sie "DeDeSales KI MCP API"

#### Unterstützte Kontotypen

I.d.R. ist hier "Nur ein Mandant - ..." mit ihrem Mandantennamen einzustellen. Benötigen wir Zugriff auf mehrere Mandanten müssen Sie dies entsprechend konfigurieren.

<p class="callout success">Klicken Sie nun auf "Registrieren"</p>

### Übersicht

#### Anwendungs-ID-Uri

Tragen Sie hier die von uns gelieferte URL ein, Beispiel: [https://demo4.ki.dedenet.dedesales.de/mcp](https://demo4.ki.dedenet.dedesales.de/mcp) ein.

### Tokenkonfiguration

Klicken Sie auf "Optionalen Anspruch hinzufügen", wählen Sie dann Zugriff und "**email**", "**preferred\_username**" und "**upn**" aus.

[![image.png](https://wiki.dedesales.de/uploads/images/gallery/2026-08/scaled-1680-/05F5Zx2qFmqrmqb4-image.png)](https://wiki.dedesales.de/uploads/images/gallery/2026-08/05F5Zx2qFmqrmqb4-image.png)

<p class="callout warning">Der Screenshot zeigt nur einen Auszug. Oben im Text stehen die benötigten Auswahlen.</p>

<p class="callout success">Klicken Sie anschließend auf "Hinzufügen". Sie müssen die anschließende Meldung noch bestätigen (Checkbox bei Aktivieren Sie die Microsoft Graph-Berechtigung "email").</p>

### API-Berechtigungen

Wir benötigen die Standard Berechtigungen, die bereits automatisch angelegt sind:

1. Microsoft Graph" User.Read Berechtigung.

<p class="callout success">Klicken Sie anschließend auf "Administratorzustimmung für "ihr tenant name" erteilen.</p>

### Eine API verfügbar machen

Klicken Sie auf "Bereich hinzufügen" und geben folgendes ein:

1. Bereichsname: access\_as\_user
2. Wer darf einwillen: Nur Administratoren
3. Anzeigename der Administratoreneinwilligung: DeDeSales MCP Server
4. Beschreibung der Administratoreneinwilligung: Hiermit erteilen Sie Zugriff auf den DeDeSales MCP Server.

<p class="callout success">Klicken Sie anschließend auf "Bereich hinzufügen"</p>

### Anwendungs-ID (Client)

Die Anwendungs-ID finden Sie, wenn Sie auf Übersicht klicken. Die nun erscheinende Anwendungs-ID kopieren, da wir diese benötigen.

### App-Registrierung #2

#### Name

Bitte verwenden Sie "DeDeSales KI MCP Client"

#### Unterstützte Kontotypen

I.d.R. ist hier "Nur ein Mandant - ..." mit ihrem Mandantennamen einzustellen. Benötigen wir Zugriff auf mehrere Mandanten müssen Sie dies entsprechend konfigurieren.

#### Umleitung URIs einrichten

Als Plattform ist "Mobilgerät- und Desktopanwendungen" zu wählen.

<p class="callout info">Die Umleitung URIs sind abhängig von Ihrem gewählten KI Provider einzugeben.</p>

<table id="bkmrk-ki-provider-umleitun" style="border-collapse:collapse;width:100%;"><colgroup><col style="width:50%;"></col><col style="width:50%;"></col></colgroup><thead><tr><td>KI Provider</td><td>Umleitungs URI</td></tr></thead><tbody><tr><td>Claude Desktop / Claude.ai</td><td>https://claude.ai/api/mcp/auth\_callback</td></tr></tbody></table>

<p class="callout success">Klicken Sie nun auf "Registrieren"</p>

### Authentication (Preview)

Klicken Sie auf Einstellungen und aktivieren "Öffentliche Clientflows zulassen".

<div drawio-diagram="2374"><img src="https://wiki.dedesales.de/uploads/images/drawio/2026-08/MUEaTMsqnBnB5ldL-drawing-8-1786965784.png" alt="MUEaTMsqnBnB5ldL-drawing-8-1786965784.png"/></div>

### API-Berechtigungen

Wir benötigen die Standard Berechtigungen, die bereits automatisch angelegt sind:

1. Microsoft Graph" User.Read Berechtigung.
2. DeDeSales KI MCP API 
    1. Dies finden Sie, in dem Sie auf Berechtigung hinzufügen klicken.
    2. Wählen Sie dann "Von meiner Organisation verwendete APIs" aus.
    3. Tippen Sie "DeDeSales KI MCP API" ein.
    4. Wählen Sie den Eintrag aus (Achtung! Es kann 15-30 Minuten dauern, bis dieser Eintrag verfügbar wird, da dieser erst kurz vorher von Ihnen angelegt wurde)
    5. Wählen Sie "Delegierte Berechtigungen" aus
    6. Unter Berechtigungen auswählen, wählen Sie "access\_as\_user" aus.
    7. Klicken Sie auf "Berechtigung hinzufügen".

<p class="callout success">Klicken Sie anschließend auf "Administratorzustimmung für "ihr tenant name" erteilen.</p>

### Anwendungs-ID (Client)

Die Anwendungs-ID finden Sie, wenn Sie auf Übersicht klicken. Die nun erscheinende Anwendungs-ID kopieren, da wir diese benötigen.

### Aus Ihrer Einrichtung heraus benötigen wir

1. Ihre TenantId

### DeDeSales Backend

Im DeDeSales Backend müssen Sie nun folgendes machen:

1. Unter Verwaltung / Benutzer wählen Sie die Benutzer aus, die MCP Zugriff er halten sollen. Bei den Benutzern aktivieren Sie die Checkbox "MCP Server aktivieren".
2. Unter Grundkonfiguration / Mitarbeiter wählen Sie nun den entsprechenden Mitarbeiter zu diesem Benutzer aus. Sollte es keine Entsprechung geben, müssen Sie einen Anlegen. Über diesen Mitarbeiter wird gesteuert auf welche Kundendaten Zugriff besteht. Wählen Sie in der Dropdown "Benutzer" den Benutzer der zuvor unter "Verwaltung / Benutzer" für den MCO Zugriff aktiviert wurde.

### KI Provider

Die Konfiguration des KI Providers kann erst erfolgen, wenn wir die Daten aus dem Abschnitt "Aus Ihrer Einrichtung heraus benötigen wir" von Ihnen erhalten und die Konfiguration abgeschlossen haben.

#### Anthropic (Claude Desktop)

Fügen Sie in Claude Desktop einen benutzerdefinierten Connector hinzu.

1. Name: DeDeSales MCP Server
2. Remote MCP Server URL: https://&lt;die von uns gelieferte domain&gt;/mcp
3. OAuth Client ID: Die Anwendungs ID aus "DeDeSales KI MCP Client