# .NET / C#

> Betten Sie den StackQL-MCP-Server als Sidecar oder per Vendoring eingebundenes Bundle in eine .NET-Anwendung ein

Source: https://stackql.io/de/mcp/embedded/dotnet

Betten Sie den StackQL-MCP-Server in eine .NET-Anwendung ein, entweder als heruntergeladenes Sidecar oder per Vendoring in Ihren Build eingebunden als eigenständige ausführbare Datei. Der Client ist das offizielle C# MCP SDK.

:::info
Die eingebettete Binärdatei wird beim ersten Start heruntergeladen und per sha256 verifiziert oder per Vendoring in Ihre App eingebunden. Siehe den [gemeinsamen Vertrag](/mcp/embedded#common-contract).
:::

* * *

## Installation

```
dotnet add package StackQL.Mcp
```

Ein optionales Paket `StackQL.Mcp.AgentFramework` ergänzt die Integration mit dem Agent Framework. Erfordert .NET 8 oder höher.

* * *

## Schnellstart

```csharp
using StackQL.Mcp;

await using var server = await StackqlMcp.CreateBuilder()
    .WithMode(StackqlMode.ReadOnly)
    .WithAuth("github", "null_auth")
    .StartAsync();

var tools = await server.ListToolsAsync();
var result = await server.CallToolAsync("list_services",
    new() { ["provider"] = "github", ["row_limit"] = 5 });
```

Die API besteht aus `StackqlMcp.CreateBuilder()` mit `.WithMode()`, `.WithAuth()`, `.WithBinary()`, `.WithBundlePath()`, `.WithApproot()` und `.WithCommand()`, gefolgt von `.StartAsync()`, `.ListToolsAsync()` und `.CallToolAsync()`.

* * *

## Modi

Der Builder verwendet standardmäßig `StackqlMode.ReadOnly`. Rufen Sie `.WithMode()` mit `StackqlMode.Safe`, `StackqlMode.DeleteSafe` oder `StackqlMode.FullAccess` auf, um zu eskalieren. Die Eskalation ist explizit - der Server aktiviert keine Mutations- oder Lifecycle-Tools, sofern Sie sich nicht ausdrücklich dafür entscheiden.

* * *

## Vendoring / Einbetten

Es gibt zwei Wege, die Binärdatei zu beziehen:

- **Sidecar (Standard)** - das Plattform-Bundle wird beim ersten Start heruntergeladen, per sha256 verifiziert, unter `~/.stackql/mcp-server-bin/<version>/<platform-key>/` zwischengespeichert und über stdio gestartet.
- **Vendored** - betten Sie das Bundle als Build-Ressource ein, um eine eigenständige ausführbare Datei zu erzeugen:

```
dotnet build -p:StackqlVendorBundle=/path/to/stackql-mcp-windows-x64.mcpb
```

Sie können die Binärdatei oder das Bundle zur Laufzeit auch mit den Umgebungsvariablen `STACKQL_MCP_BIN` oder `STACKQL_MCP_BUNDLE` überschreiben.

* * *

## Demo-App

**driftwatch** ist ein .NET Worker Service, der den schreibgeschützten StackQL-Server einbettet, nach Zeitplan eine Suite von SQL-Drift-Prüfungen ausführt (öffentliche Erreichbarkeit, fehlende Tags oder Lizenzen, Baseline-Drift) und die Ergebnisse als Teams Adaptive Card sendet.

* * *

## Repository-Link

[github.com/stackql/stackql-mcp-dotnet](https://github.com/stackql/stackql-mcp-dotnet)