Smartsheet über MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Smartsheet klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Smartsheet + Microsoft Copilot

Smartsheet API 2.0 mit persönlichem Access Token (US, EU, AU oder Gov): Sheets, Zeilen, Spalten, Sheet-Zusammenfassungen und Zellverlauf, Kommentare und Anhänge, Workspaces, Ordner, Berichte und Dashboards, Benutzer und Freigaben suchen und lesen; Zeilen und Spalten anlegen und ändern, kommentieren, Sheets erstellen, freigeben und Aktualisierungsanfragen senden. Zeilen löschen ist bei der Installation aus.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

SMARTSHEET_API_URL, SMARTSHEET_ACCESS_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 2 Minuten. Du brauchst einen Smartsheet-Tarif mit API-Zugriff (Pro, Business, Enterprise oder Advanced Work Management).

1. Melde dich bei Smartsheet an, klick unten links auf dein Kontosymbol und öffne Apps & Integrations (oder Personal Settings), dann API Access.
2. Klick auf Generate new access token, gib ihm einen Namen wie AnythingMCP und kopiere das Token. Es wird nur einmal angezeigt.
3. Füge es in SMARTSHEET_ACCESS_TOKEN ein, ohne das Wort Bearer.
4. Setz SMARTSHEET_API_URL auf den Host der Region deines Kontos: https://api.smartsheet.com/2.0 für app.smartsheet.com (US), https://api.smartsheet.eu/2.0 für app.smartsheet.eu, https://api.smartsheet.au/2.0 für app.smartsheet.au oder https://api.smartsheetgov.com/2.0 für Smartsheet Gov. Ein Token funktioniert nur auf dem Host seiner eigenen Region; überall sonst antwortet Smartsheet mit 401 „invalid access token“.
5. Installiere den Connector und rufe smartsheet_get_current_user auf: Es zeigt, wem das Token gehört, und bestätigt es.

Wessen Zugriff: Jeder Aufruf läuft als der Benutzer, dem das Token gehört, mit dessen Zugriff auf jedes Sheet, und das Token darf alles, was sein Benutzer in Smartsheet darf. Wenn das wichtig ist, erzeuge das Token mit einem eigenen Benutzer, der nur Zugriff auf die Sheets hat, die die KI sehen soll.

Was er liest: eine Suche über alles, was der Benutzer öffnen kann (Namen von Sheets, Berichten, Dashboards, Ordnern, Workspaces und Vorlagen, Zelldaten, Kommentare, Anhänge und Zusammenfassungsfelder), eingegrenzt mit scopes wie sheetNames; Sheets mit ihren Spalten (Typ, Dropdown-Optionen, Primärspalte) und Zeilen, jede mit Zeilennummer, übergeordneter Zeile für die Hierarchie und Zellen als value und displayValue; eine einzelne Zeile; eine Textsuche innerhalb eines Sheets; die Felder der Sheet-Zusammenfassung; den Änderungsverlauf einer Zelle mit wer wann geändert hat; Kommentar-Threads auf Sheets und Zeilen; Anhänge mit einem Download-Link, der etwa 2 Minuten gilt; Workspaces und Ordner mit ihrem Inhalt; Berichte mit Zeilen aus mehreren Sheets, Zellen über virtualColumnId; Dashboards (in der API Sights genannt) mit ihren Widgets; die Benutzer des Organisationskontos (Systemadmins sehen alle, andere eine eingeschränkte Ansicht) und mit wem ein Element geteilt ist.

Große Sheets: Die KI listet zuerst die Spalten für deren IDs und Typen und liest dann eine Seite Zeilen oder nur bestimmte Zeilen mit row_numbers, row_ids, column_ids oder rows_modified_since.

Was er schreibt: smartsheet_add_rows und smartsheet_update_rows (nur die angegebenen Zellen ändern sich; ein Positionsfeld verschiebt eine Zeile), smartsheet_add_columns und smartsheet_update_column (ein Typwechsel kann Zellwerte umwandeln oder verwerfen), neue Kommentar-Threads auf Sheets und Zeilen und Antworten darauf, neue Sheets in einem Workspace oder Ordner mit eigenen Spalten oder als Kopie einer Vorlage oder eines Sheets, smartsheet_share_asset und smartsheet_create_update_request. Diese Tools sind bei der Installation aktiv. Freigaben und Aktualisierungsanfragen mit send_email verschicken E-Mails, und Follower eines Sheets werden eventuell über neue Kommentare benachrichtigt; deshalb zeigt dir die KI zuerst Empfänger, Zugriffsstufe und Inhalt und wartet auf dein Ja.

Zellen schreiben: Eine Zelle ist {"columnId": <id>, "value": <value>}. DATE nimmt YYYY-MM-DD, CHECKBOX true oder false, PICKLIST eine ihrer Optionen (andere Werte werden abgelehnt, außer strict ist false), CONTACT_LIST eine E-Mail-Adresse, Zahlen werden als Zahlen gesendet. Eine Formel kommt in "formula": "=..." statt in value. Neue Zeilen brauchen eine Position: toBottom, toTop, parentId oder siblingId. Spalten mit Spaltenformel, Systemspalten (Autonummer, Erstelldatum, Geändert von) und gesperrte Spalten lassen sich nicht beschreiben.

Bei der Installation deaktiviert: smartsheet_delete_rows, denn gelöschte Zeilen samt ihren untergeordneten Zeilen, Anhängen und Kommentaren lassen sich über die API nicht wiederherstellen. Ein Admin schaltet es ein, wenn das Team es braucht.

Datenformate: Sheets, Zeilen, Spalten, Workspaces, Ordner, Berichte und Benutzer haben lange numerische IDs (bis zu 16 Stellen), die die KI als Text genau so übergibt, wie sie zurückkommen. Datum und Uhrzeit sind ISO 8601 in UTC; Datumszellen sind YYYY-MM-DD. Zellen mit mehreren Kontakten oder Mehrfachauswahl kommen als Text zurück, außer level (2 oder 3) und include=objectValue werden übergeben. accessLevel ist VIEWER, COMMENTER, EDITOR, EDITOR_SHARE, ADMIN oder OWNER. Schreibaufrufe antworten mit {"message": "SUCCESS", "resultCode": 0, "result": ...}; resultCode 3 bedeutet teilweisen Erfolg.

Paginierung: Sheets, Spalten, Diskussionen, Anhänge, Benutzer und Zellverlauf blättern mit page und page_size (standardmäßig 100; die Antwort enthält totalPages und totalCount) oder include_all. Workspaces, Inhalte von Workspaces und Ordnern, Dashboards und Freigaben blättern mit einem Token: Die KI übergibt lastKey aus der Antwort als last_key, bis es fehlt.

Limits: 300 Anfragen pro Minute und Token, 30 pro Minute für den Zellverlauf. Eine 429-Antwort (Fehlercode 4003) heißt eine Minute warten. Ein Sammelaufruf für Zeilen zählt als eine Anfrage; bleib dabei unter einigen hundert Zeilen.

Häufige Fehler: 401 (Codes 1002, 1003, 1004) heißt ungültiges oder abgelaufenes Token oder der Host einer anderen Region. 403 (1004) heißt, der Benutzer des Tokens darf das Element nicht öffnen: Teile es mit diesem Benutzer oder nimm das Token eines Benutzers mit Zugriff. 404 (1006) heißt, die ID existiert nicht oder ist für den Benutzer nicht sichtbar. 400 kommt mit einem errorCode und einer message, die das Problem nennt, etwa ein Wert, der nicht in der Dropdown-Liste steht, eine neue Zeile ohne Position oder ein Schreibversuch in eine Spalte mit Spaltenformel.

Der Connector lädt keine Dateien hoch, löscht keine Sheets oder Spalten und legt keine Workspaces oder Ordner an.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Microsoft Copilot hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Smartsheet-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Zeig alle Zeilen im Sheet Projekt-Tracker mit Status At Risk, mit Verantwortlichem und Fälligkeitsdatum.“
• „Füg unten im Sheet Marketingkalender eine Zeile hinzu: Webinar, 2026-11-20, Verantwortlich [email protected], Status Geplant.“
• „Wer hat die Budget-Zelle in Zeile 14 des Sheets Budget Q4 geändert, und welche Werte standen vorher drin?“
• „Finde alle Sheets, Kommentare und Anhänge, in denen Projekt Apollo vorkommt.“
• „Lies die Sheet-Zusammenfassung von Website-Relaunch und sag mir den Gesamtstatus und den Fertigstellungsgrad.“

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden