Verbinden Sie HubSpot mit Claude mithilfe von MCP

HubSpotKostenloser PlanAbfrageströmeClaude

Fragen Sie Claude in einfachem Englisch zu Ihrem HubSpot-Konto: Der Agent in Ihrem Netzwerk führt die SQL-Abfrage bereits schreibgeschützt aus, und Ihr KI-Client erhält niemals Ihre Anmeldedaten. Das dauert etwa zehn Minuten, und der Free-Tarif reicht dafür aus.

Kostenlos starten

Was am Ende dabei herauskommt

Ein Agent namens Claude, der Fragen zu Ihrem HubSpot-Konto mit Live-Abfragen (nur lesend) beantworten, die Bedeutung der Spalten erklären und bei weiteren Fragen nachfassen kann – ohne Datenbankzugriff und ohne Firewall-Änderungen: Der bereits in Ihrem Netzwerk befindliche Agent führt die SQL-Abfragen aus und sendet nur die Zeilen zurück. Sobald der Agent eingerichtet ist, dauert die Verbindung zu Claude etwa 90 Sekunden, sofern Sie mit den Einstellungen vertraut sind. So geht's:

Claude ChatGPT Cursor Claude Code VS Code Windsurf Gemini CLI JetBrains Kodex+5 weitereSchreibgeschützt

Was ist in hubspot.deals in meinem HubSpot-Konto? Zeigen Sie mir ein paar Zeilen und erklären Sie mir die Bedeutung der einzelnen Spalten.

qs_get_table_schema qs_run_query Schema-Intelligenz

Ich habe mir zunächst die Tabellenstruktur angesehen und anschließend eine Leseabfrage über Ihren Agenten ausgeführt. Hier sind drei der Zeilen aus hubspot.deals:

Dealname	Dealstage	Menge
1042	Northwind Traders	Seattle
1057	Alpine Outfitters	Denver
1063	Harbour Foods	Halifax

Dealname identifiziert die Zeile. Dealstage und Menge sind in Ihrem Semantic Intelligence-Modell beschrieben, sodass ich sie anhand ihres Namens filtern kann.

Welche drei Menge Welche Werte haben in diesem Quartal den größten Umsatz generiert? Wie verhält sich das im Vergleich zum letzten Quartal? Gibt es etwas, das ich mir genauer ansehen sollte?

qs_get_relationships qs_run_query qs_run_query

Ich habe mich angeschlossen hubspot.deals zu Bestellungen Auf Grundlage der von Semantic Intelligence gefundenen Beziehung wurde anschließend für jedes Quartal eine Aggregation durchgeführt. Beide Abfragen waren schreibgeschützt und lieferten jeweils 3 Zeilen zurück:

Menge	Dieses Quartal	Letztes Quartal	Ändern
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	-26 %

Denver Die Geschichte lautet: Der Umsatz stieg um 38 % bei nahezu gleichbleibender Kundenzahl, wodurch der durchschnittliche Bestellwert stieg. Halifax Der Umsatz sank um 26 %, und der Rückgang betrifft zwei Kunden, die im letzten Quartal jeden Monat bestellt hatten, in diesem Quartal aber gar nicht – ein Anruf vor Monatsende lohnt sich. In Seattle blieb alles unverändert. Möchten Sie die beiden Halifax-Konten namentlich nennen?

Nur SELECT, geprüft vom Agenten Im MCP-Aktivitäts-Tab angemeldet 9 Zeilen wurden in 3 Abfragen zurückgegeben. Gleiche Verbindung in 14 MCP-Clients

Lieber gar keinen KI-Client einrichten? Zum Geschäftsplan Nova Der in Query Streams integrierte Assistent nutzt dieselben Agenten-Tools wie Ihr KI-Client und bietet darüber hinaus Funktionen, die externe Clients nicht haben: Er erstellt und validiert die SQL-Abfrage anhand Ihres Semantic-Intelligence-Modells, wandelt das Ergebnis in ein Diagramm um und speichert es als Abfrage, die Ihr Team aus Excel, Google Sheets oder der REST-API ausführen kann – ganz ohne Schlüssel, Konnektor oder Installation. Nutzen Sie MCP, wenn Ihre Mitarbeiter bereits mit Claude, Cursor oder ChatGPT arbeiten; verwenden Sie Nova, wenn Sie die Ergebnisse direkt im Portal benötigen.

HubSpot speichert Ihre Daten hinter seiner API. Claude hingegen läuft in einem Browser oder Terminal und hat keinerlei Kenntnis davon. Üblicherweise wird ein Schema in den Chat eingefügt und auf das Beste gehofft oder einem Open-Source-MCP-Server das HubSpot-Passwort übergeben. Query Streams geht anders vor: Der Agent, der bereits mit Ihrem HubSpot-Konto verknüpft ist, führt die von Claude geschriebenen SQL-Abfragen schreibgeschützt aus. Der MCP-Server prüft zwischenzeitlich, wer die Anfrage stellt, welche Aktionen ausgeführt werden und wie oft. Claude erhält Antworten, aber niemals Zugangsdaten.

Was Sie benötigen

Ein Query Streams-Konto

MCP ist in allen Tarifen enthalten, auch in der kostenlosen Version. Die kostenlose Version erlaubt einen Schlüssel oder eine verbundene App – mehr benötigt dieser Leitfaden nicht. Melden Sie sich an unter mein.querystreams.de.

HubSpot-Verbindung über den Agenten

Der Agent wird auf jedem ständig eingeschalteten Computer installiert, wobei die HubSpot-Verbindung in den Datenagenten hinzugefügt wird. Noch nicht fertig? Verbinden Sie zuerst HubSpot.Es dauert ungefähr zehn Minuten.

MCP ist für Sie aktiviert

Ersteller, Eigentümer und Administratoren haben von Anfang an Zugriff darauf. Alle anderen benötigen einen Administrator, der die Einstellungen ändert. MCP Schalter neben ihrem Namen unter Konto → ZugriffskontrolleBis dahin heißt es auf der MCP-Seite: „MCP ist für Ihr Konto deaktiviert.“

Ein KI-Client

Chat-Apps wie claude.ai, Claude Desktop und ChatGPT verbinden sich ohne Schlüssel. Claude Code, Cursor, VS Code und etwa zehn weitere Tools verwenden einen Schlüssel; das Portal hingegen schon. Verbinden Sie einen KI-Client Der Leitfaden richtet jedes einzelne Gerät ein.

Richten Sie es in vier Schritten ein

1. MCP im Portal öffnen

   Anmelden unter mein.querystreams.de und öffnen Streams → Live → MCPDie Seite hat vier Registerkarten: Verbindungen, Kontext, Werkzeuge und für Administratoren AktivitätÜberprüfen Sie das Panel „Semantische Intelligenz“ auf Verbindungen Hier wird Ihr HubSpot-Connector aufgelistet und angezeigt, ob Semantic Intelligence darauf ausgeführt wurde. Dank dieser vollständigen Abdeckung kann Claude auf Anhieb korrekte HubSpot-SQL-Abfragen schreiben.

   MCP öffnen

   Wird die Meldung „MCP ist für Ihr Konto deaktiviert“ angezeigt? Ihre Organisation nutzt MCP, aber Ihr Benutzer ist deaktiviert. Ein Administrator aktiviert es mit dem MCP Schalter neben Ihrem Namen unter Konto → ZugriffskontrolleSchöpfer, Eigentümer und Administratoren sind von Anfang an dabei.

2. Wählen Sie aus, wie Sie die Verbindung herstellen möchten.

   Es gibt zwei Wege hinein, und sie enden am selben Ort:

   Chat-Apps · keine Taste

   claude.ai, Claude Desktop, ChatGPT

   Öffnen Sie in claude.ai und Claude Desktop die Abfragestreams-Liste Klicken Sie im Connectors Directory von Anthropic darauf. Verbinden und genehmigen. Hinzufügen per URL, https://mcp.querystreams.com/mcpDies ist die Ausweichlösung. In ChatGPT fügen Sie Abfragestreams über die App hinzu (derzeit im Entwicklermodus) und melden sich mit Abfragestreams an. In beiden Fällen öffnet sich eine Abfragestreams-Seite: Wählen Sie die Organisation und die Berechtigungen aus und klicken Sie auf Verbindung genehmigenNichts zum Kopieren. Die Verbindung erscheint auf dem Verbindungen Der Tab kann dort aufgerufen und widerrufen werden.

   Entwicklertools · ein Schlüssel

   Claude Code, Cursor, VS Code und Freunde

   Klicken Sie auf der MCP-Seite Verbinden Sie einen KI-ClientDer Reiseführer fragt Wie wird Ihr KI-Client die Verbindung herstellen?: wählen Verwenden Sie einen Schlüssel in einer KonfigurationsdateiWähle dein Werkzeug aus, dann Generieren Sie einen Schlüssel für es: ein Schlüsselname, Lesen und Abfragen ausführen angekreuzt, ein Ablauf (Nie, 30 Tage, 90 Tage oder 1 Jahr). Richten Sie es ein. zeigt den Codeausschnitt mit der ausgefüllten Legende, und Überprüfen Sie die Verbindung. wartet auf den ersten Anruf.

   Beide Methoden verwenden dieselben drei Berechtigungen, die Sie entweder auf dem Zustimmungsbildschirm oder auf dem Schlüssel auswählen:

   Lesen

   Listen Sie Konnektoren auf, durchsuchen Sie Tabellen und Spalten, lesen Sie Ihre gespeicherten Abfragen und Benachrichtigungsregeln. Es werden niemals Zeilendaten zurückgegeben.

   Abfragen ausführen

   Führen Sie schreibgeschützte SQL-Abfragen und gespeicherte Abfragen über Ihren Agenten aus und geben Sie die Zeilen zurück. Andernfalls kann Ihr KI-Client Ihre Daten zwar beschreiben, aber keine Antworten darauf geben.

   Analysieren

   Profiltabellen werden erstellt, Beziehungen erkannt und ein Lauf der semantischen Intelligenz in die Warteschlange gestellt. Dies verbraucht Nova-KI-Credits und Datenvolumen, sodass die Zustimmungsabfrage diese Option nicht vorauswählt.

   Schlüssel verloren? Es ist aufgeführt auf der Verbindungen Tab: Vollständigen Schlüssel anzeigen zeigt es erneut und Vollständigen Schlüssel kopieren Kopiert es. Entzieht es dort, wenn ein Laptop verloren geht; jeder Client, der es benutzt, schlägt beim nächsten Anruf innerhalb von etwa fünf Minuten fehl.

3. Verbinde dich mit Claude

   Wählen Sie das Rezept für den Claude, den Sie verwenden möchten. Die Serveradresse ist überall gleich: https://mcp.querystreams.com/mcp.

   Claude im Web, Claude Desktop und Mobilgeräte kein Schlüssel

   1. Öffnen Sie die Abfragestreams-Liste im Connectors Directory von Anthropic und klicken Sie VerbindenIn der Desktop-Umgebung befindet es sich dann unter + → Connectoren.
   2. Ausweichlösung, falls Ihre Organisation Verzeichnisverbindungen ausblendet: Einstellungen → Konnektoren → Benutzerdefinierten Konnektor hinzufügen, Name Abfrageströme, URL https://mcp.querystreams.com/mcp, OAuth-Felder leer, Hinzufügendann in einem Chat + → Abfrageströme → Verbinden.
   3. Es öffnet sich ein Tab „Abfrageströme“. Melden Sie sich gegebenenfalls an, wählen Sie die Organisation aus und überprüfen Sie die Abfrage. Lesen und Abfragen ausführenoptional Beschränkung auf bestimmte Anschlüsseund klicken Sie Verbindung genehmigen.
   4. Zurück in Claude sehen Sie „Mit Abfrageströmen verbunden“. Wenn Claude zum ersten Mal ein Tool verwendet, werden Sie gefragt; wählen Sie Immer erlauben.

   Wenn Sie es manuell in Claude Desktop hinzufügen, verwenden Sie Einstellungen → Konnektoren → Hinzufügennicht der Chat Marktplatz hinzufügen Diese Option erfordert ein Git-Repository. Konnektoren werden mit Ihrem Claude-Konto synchronisiert, sodass die mobilen Apps und die Desktop-Version es automatisch erkennen. Die Menünamen stammen von Anthropic und können geändert werden.

   Claude Code Schlüssel

   Ein Befehl, mit Ihrem Schlüssel aus der Registerkarte „Verbindungen“:

   Terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PASTE_YOUR_KEY_HERE"

   Das schreibt das aktuelle Projekt. .mcp.json. Hinzufügen --scope Benutzer Query Streams in jedem Projekt haben. Ausführen /mcp Im Claude-Code sehen Sie, ob die Verbindung besteht.

   Cursor Schlüssel

   Öffnen Cursor-Einstellungen → MCP → Neuen MCP-Server hinzufügenoder bearbeiten .cursor/mcp.json im Stammverzeichnis Ihres Arbeitsbereichs:

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_PASTE_YOUR_KEY_HERE" } } } }

   Cursor neu starten oder ausführen MCP: Server neu starten; A Abfrageströme Das Symbol erscheint in der MCP-Statusleiste.

   Etwas anderes verwenden? Das Portal Verbinden Sie einen KI-Client Führung enthält sofort einsatzbereite Rezepte für ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev und JetBrains AI sowie ein Einfügen und Zusammenführen Werkzeug, das die Abfrageströme Eintrag in eine bereits vorhandene Konfigurationsdatei. Jeder Client, der MCP über HTTP unterstützt, funktioniert: Server https://mcp.querystreams.com/mcp, Kopfzeile X-MCP-Schlüssel (ein Autorisierung: Inhaber (Auch eine Kopfzeile mit demselben Schlüssel funktioniert.)

4. Stelle deine erste Frage

   Beginnen Sie mit einer Frage, deren Antwort Sie bereits kennen, damit Sie sehen können, wie Claude das richtige Tool auswählt. Drei Beispiele, die gut mit Ihrem HubSpot-Konto funktionieren:

   „Welche Daten befinden sich in meinem HubSpot-Konto?“

   Claude listet die Tabellen auf, die er sehen kann, teilt Ihnen mit, welche Tabellen über semantische Intelligenz verfügen, und fragt Sie, was Sie sich ansehen möchten.

   „Zeigen Sie mir zehn Zeilen von hubspot.deals und erklären Sie jede Spalte.“

   Claude liest zuerst die Tabellenstruktur (Lesen), führt dann eine SELECT-Abfrage über Ihren Agenten aus (Abfragen ausführen) und beschreibt, was Dealphase und Betrag bedeuten.

   „Wie viele Zeilen hat hubspot.deals pro Betrag? Welcher Betrag hat die meisten?“

   Claude formuliert die GROUP BY-Klausel im HubSpot-Dialekt, führt sie aus und antwortet mit einem Satz und einer kleinen Tabelle. Die weitere Kommunikation erfolgt im selben Chat, um den Kontext zu erhalten.

   Um die Verkabelung zu überprüfen, fragen Sie „Welche Query Streams-Konnektoren habe ich?“Claude ruft an qs_list_connectors, der Portal-Leitfaden Überprüfen Sie die Verbindung. Schritt sagt Verbundenund der Schlüssel oder die App auf dem Verbindungen Der Tab zeigt seine Zuletzt verwendet Zeit innerhalb weniger Sekunden.

Was Claude tun kann, sobald er verbunden ist

Ihr KI-Client erkennt die Abfragestream-Tools und wählt das passende für Ihre Frage aus. Das Portal Werkzeuge Registerkarte listet alle Tools und Modi auf, die in deinem Tarif enthalten sind. Query Streams fordert deinen KI-Client auf, vor einer Abfrage die Spalten jeder Tabelle auszulesen, damit er die tatsächlichen Namen verwendet, statt zu raten. In jedem Tarif, auch im kostenlosen:

Das Analyse-Toolset. Bei kostenpflichtigen Tarifen übernimmt der Agent die Vorarbeit in Ihrem HubSpot-Konto, sodass sich Ihr KI-Client auf die eigentliche Denkarbeit konzentrieren kann. Die kostenlose Version funktioniert wie gewohnt.

Die Standardeinstellungen befinden sich auf der Kontext Registerkarte: Textzellenlimit, Schemaansicht, Ergebnisgröße, Analysevorgaben und gespeicherte Ergebnisse.

Warum semantische Intelligenz hier wichtig ist

Jede Antwort, die Claude erhält, wird mit dem Hinweis versehen, woher die Struktur stammt, und Claude passt an, wie sehr er dem Gesehenen vertraut.

Wenn eine Datenbank wichtig ist, führen Sie Semantic Intelligence einmalig darauf aus. Nova → Intelligenz. Der Verbindungen Die Registerkarte zeigt ein Abdeckungsfeld pro Anschluss an. Wie semantische Intelligenz funktioniert.

Was die Pläne erlauben

MCP ist in jedem Tarif, auch im kostenlosen Tarif, ohne zusätzliche Gebühren enthalten. Jeder Tarif legt fest, wie viele Schlüssel oder verbundene Apps Sie halten können und wie viele Anrufe pro Minute Ihr KI-Client tätigen darf:

Eine verbundene App zählt als Schlüssel. Zusätzlich zur Minutenzahl kann jeder Schlüssel maximal 10 Abfragen pro Minute ausführen. Eine Abfrage dauert bis zu 60 Sekunden, es sei denn, Ihr KI-Client fordert mehr an, bis zu fünf Minuten. Ihr Plan legt außerdem fest, wie viele Zeilen eine Abfrage zurückgibt und, mit den Analysetools, wie lange und wie groß ein gespeichertes Ergebnis sein darf; der vollständige MCP-Leitfaden listet alle Pläne auf. Was Ihr KI-Client empfängt, wird auf Ihr Data-Realm-Kontingent angerechnet – denselben Pool, den auch Ihre Excel- und Sheets-Abfragen nutzen: Bei der Nutzung des KI-Agenten (MCP) zählt jedes Byte, das an Ihren KI-Client geliefert wird, also Ergebnisse, Schema-Lesevorgänge und Seiten mit zurückgehaltenen Ergebnissen, und zwar vor einer etwaigen Transportkomprimierung, die Ihr Client aushandelt. Bei Tabellenkalkulationsabfragen zählt hingegen das komprimierte Ergebnis, das Ihr Network Agent liefert. Semantic-Intelligence-Ausführungen, die von Ihrem KI-Client gestartet werden, verbrauchen Nova-AI-Credits – genau wie Ausführungen über das Portal. Siehe die Preisseite für die Zulagen.

Es sicher aufbewahren

Gute nächste Schritte

• Speichern Sie die Abfragen, die Sie als kanonisch betrachten. Im Abfrage-Generator greift Claude zuerst auf gespeicherte Abfragen zu, daher bedeutet „aktive Kunden“ genau das, was Ihr Team darunter versteht.
• Verwenden Sie ein Claude-Projekt mit angehängten Query Streams und fügen Sie Ihre Hausregeln in die Anweisungen ein: welche HubSpot-Datenbank standardmäßig verwendet werden soll, welche gespeicherten Abfragen die offiziellen Definitionen sind.
• Grant Analyze, wenn Sie tiefergehende Antworten wünschen. Die Profilerstellung einer Spalte vor dem Filtern ist der Unterschied zwischen dem Raten eines Statuscodes und der Verwendung des richtigen. Dies verbraucht Nova-KI-Credits und ist daher deaktiviert, bis Sie es explizit anordnen.
• Bitten Sie um eine Übersicht. claude.ai erstellt Diagramme aus den Zeilen, die Claude zurückerhält.

Wenn etwas nicht funktioniert

Fragen, die Menschen stellen

Verwandte Leitfäden

• Verbinden Sie Stripe mit Claude mithilfe von MCP
• Verbinde Shopify mit Claude mithilfe von MCP
• Verbinden Sie Google Analytics 4 mit Claude mithilfe von MCP
• Verbinden Sie die Google Search Console mit Claude mithilfe von MCP
• Query Streams über MCP mit Claude verbinden: Einrichtung, Berechtigungen und Fehlerbehebung
• So verbinden Sie HubSpot mit Google Sheets
• Alle MCP-Leitfäden