KnowSync AI
offiziellVerwandeln Sie Ihre verstreute Dokumentation in KI-bereites Wissen, das nahtlos mit Claude, Cursor, VS Code und anderen KI-Tools funktioniert.
Was kann man mit KnowSync AI MCP machen?
- Wissensdatenbank durchsuchen — Bitten Sie Ihre KI, relevante Dokumente und Inhalte mithilfe von
knowsync_querymit automatischer Absichtserkennung und KI-gestütztem Re-Ranking zu finden. - Dokumente verwalten — Verwenden Sie
knowsync_manage, um Dokumente für Wissensdatenbank-Audits aufzulisten, zu durchsuchen und nach Status oder Inhaltstyp zu filtern. - Webinhalte hinzufügen — Lassen Sie Ihre KI bestimmte URLs crawlen oder relevante Webseiten entdecken, um sie automatisch über
knowsync_managezu Ihrer Wissensdatenbank hinzuzufügen. - Sitzungsbewusste Folgefragen — Stellen Sie kontextbezogene Folgefragen in derselben Konversation, wobei
knowsync_queryden Kontext für natürliche Multi-Turn-Abfragen bewahrt.
Dokumentation
No headings found
Verbinden Sie KI-Agenten mit Ihrer KnowSync-Wissensdatenbank über das Model Context Protocol (MCP). Richten Sie API-Schlüssel ein, konfigurieren Sie Tools und integrieren Sie Claude, Cursor und andere KI-Assistenten.
15 Min. LesezeitVon KnowSync Team9/18/2025
MCP-Integration
Der Model Context Protocol (MCP)-Server von KnowSync ermöglicht KI-Agenten den Echtzeitzugriff auf die Wissensdatenbank Ihres Unternehmens. Verbinden Sie Claude, Cursor, VS Code und andere KI-Tools, um nahtlos in Ihrer Wissensdatenbank zu suchen, abzurufen und Inhalte hinzuzufügen.
Was ist MCP?
Überblick
Das Model Context Protocol (MCP) ist ein von Anthropic entwickelter offener Standard, der KI-Anwendungen den sicheren Zugriff auf externe Datenquellen ermöglicht. Der MCP-Server von KnowSync bietet 2 einheitliche Tools mit intelligentem Caching, KI-gestützter Abfrageoptimierung und Sitzungsverwaltung, die es KI-Agenten ermöglichen, über eine standardisierte JSON-RPC 2.0-API mit Ihrer Wissensdatenbank zu interagieren.
Hauptfunktionen
2 einheitliche Tools:
- Universelle Abfrage: Intelligente Suche und Abruf mit automatischer Absichtserkennung, KI-gestütztem Re-Ranking, intelligentem Caching und sitzungsbewusster Kontexterhaltung
- Dokumentenverwaltung: Umfassende Inhaltsverwaltung einschließlich Web-Crawling, Discovery und Dokumentoperationen mit Nutzungsverfolgung
Enterprise-Sicherheit:
- API-Schlüssel-Authentifizierung mit granularen Berechtigungen
- Ratenbegrenzung und Nutzungsverfolgung
- Teammitglieder-Zuordnung für alle Anfragen
- IP-Einschränkungen und Zugriffskontrollen
Einrichtung von MCP-API-Schlüsseln
Erstellen Ihres ersten API-Schlüssels
- Auf MCP-Dashboard zugreifen: Navigieren Sie zu Ihrem Organisations-Dashboard und klicken Sie auf die Karte MCP Server
- Zum Tab API-Schlüssel gehen: Klicken Sie auf den Abschnitt API-Schlüssel
- Neuen Schlüssel erstellen: Klicken Sie auf die Schaltfläche API-Schlüssel erstellen
- Schlüsseleinstellungen konfigurieren:
- Name: Beschreibender Name (z. B. „Claude Desktop", „Entwicklungstests")
- Berechtigungen: Wählen Sie aus, auf welche Tools der Schlüssel zugreifen kann
- Ratenlimit: Legen Sie Anfragen pro Stunde fest (basierend auf Ihrem Plan)
- Name: Beschreibender Name (z. B. „Claude Desktop", „Entwicklungstests")
Verfügbare MCP-Tools
KnowSync bietet 2 leistungsstarke einheitliche MCP-Tools, die die Funktionalität unseres bisherigen 5-Tool-Systems kombinieren:
Universelle Tools (Alle Pläne)
knowsync_query:
- Universelle Suche und Inhaltsabruf mit intelligentem Caching (60–85 % schnellere Antworten)
- Automatische Absichtserkennung (Suche vs. Abruf) mit Abfrageerweiterung und -optimierung
- Sitzungsbewusste Kontexterhaltung für Folgeabfragen mit Gesprächsspeicher
- Intelligente Parameterabstimmung basierend auf KI-Abfrageklassifizierung und Konfidenzbewertung
- KI-gestütztes Re-Ranking der Ergebnisse für verbesserte Relevanz (Pro+-Pläne)
- Embedding-Ähnlichkeits-Cache für blitzschnelle Wiederholungsabfragen
Verwaltungstools (Alle Pläne)
knowsync_manage:
- Umfassende Dokumentenverwaltungsoperationen mit Nutzungsverfolgung
- Dokumente auflisten und durchsuchen mit erweiterter Filterung und Statusüberwachung (0,5 API-Einheiten)
- Bestimmte Webseiten mit vollständiger Vektorverarbeitung zu Ihrer Wissensdatenbank hinzufügen (2 API-Einheiten pro URL: 1 Crawl + 1 Verarbeitung)
- Relevante Webinhalte recherchieren und entdecken mit automatischer Verarbeitung (2 API-Einheiten pro entdeckter URL)
- Einheitliche Oberfläche für alle Dokumentoperationen mit detaillierter API-Verbrauchsverfolgung
Berechtigungskonfiguration
Tool-Ebenen-Berechtigungen: Jedem API-Schlüssel kann je nach Bedarf Zugriff auf bestimmte Tools gewährt werden:
- Nur Suche: Ideal für reine Lese-KI-Agenten
- Voller Zugriff: Vollständiger Zugriff auf alle verfügbaren Tools
- Benutzerdefiniert: Bestimmte Tools für spezielle Anwendungsfälle auswählen
Ratenbegrenzung: Konfigurieren Sie Anfragelimits basierend auf Nutzungsmustern:
- Kostenloser Plan: Maximal 60 Anfragen/Stunde
- Starter-Plan: Bis zu 600 Anfragen/Stunde
- Professional-Plan: Bis zu 3.000 Anfragen/Stunde
- Enterprise-Plan: Benutzerdefinierte Limits verfügbar
Integration mit KI-Tools
Claude Desktop Einrichtung
Voraussetzungen:
- Claude Desktop-Anwendung (neueste Version)
- KnowSync-API-Schlüssel mit entsprechenden Berechtigungen
- Benutzeridentifikation für Teamverfolgung
Konfiguration:
- Server-URL abrufen:
https://www.knowsync.ai/api/mcp - Zu den Claude Desktop-Einstellungen hinzufügen:
{
"mcpServers": {
"knowsync": {
"url": "https://www.knowsync.ai/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY",
"X-User-Id": "your_user_id_here"
}
}
}
}
Cursor IDE-Integration
Einrichtungsanweisungen:
- Cursor-Einstellungen öffnen (
Cmd/Ctrl + ,) - Zum MCP-Abschnitt navigieren
- KnowSync-Server hinzufügen:
{
"mcpServers": {
"knowsync": {
"url": "https://www.knowsync.ai/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY",
"X-User-Id": "your_user_id_here"
}
}
}
}
VS Code-Integration
MCP-Erweiterung verwenden:
- MCP-Erweiterung für VS Code installieren
- In settings.json konfigurieren:
{
"mcp.servers": {
"knowsync": {
"url": "https://www.knowsync.ai/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY",
"X-User-Id": "your_user_id_here"
}
}
}
}
Claude Code Einrichtung
Voraussetzungen:
- Claude Code CLI installiert (Installation über
npm install -g @anthropic-ai/claude-codeoder offizielle Installationsanleitung befolgen) - KnowSync-API-Schlüssel mit entsprechenden Berechtigungen
- Ihre KnowSync-Benutzer-/E-Mail-ID (in den Profileinstellungen zu finden)
Konfiguration:
- KnowSync-MCP-Server über die Claude-CLI hinzufügen:
- mit Benutzer-ID:
claude mcp add --transport http knowsync https://www.knowsync.ai/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "X-User-Id: your_user_id_here"
- mit Benutzer-E-Mail:
claude mcp add --transport http knowsync https://www.knowsync.ai/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "X-User-Email: your_user_email_here"
- Konfiguration überprüfen:
claude mcp list
Dies sollte den knowsync-Server in der Liste anzeigen.
Hinweis: Stellen Sie sicher, dass Ihr API-Schlüssel über die erforderlichen Tool-Berechtigungen verfügt. Ersetzen Sie Platzhalter durch tatsächliche Werte.
Teammitglieder-Verfolgung
Erforderliche Header: Alle MCP-Anfragen müssen eine Benutzeridentifikation für die korrekte Zuordnung enthalten:
- X-User-Id: Ihre KnowSync-Benutzer-ID (in den Profileinstellungen zu finden)
- X-User-Email: Ihre registrierte E-Mail-Adresse
Warum dies erforderlich ist:
- Nutzung einzelner Teammitglieder verfolgen
- Pro-Benutzer-Analysen und Einblicke generieren
- Ordnungsgemäße Prüfpfade sicherstellen
- Nutzungsbasierte Abrechnung und Limits ermöglichen
Praxisbeispiele für die MCP-Nutzung
Integration in den Entwicklungs-Workflow
Szenario 1: Code-Review-Assistent
Anwendungsfall: KI-Agent unterstützt bei Code-Reviews, indem er auf die Codierungsstandards und Best Practices Ihres Teams zugreift.
# Query for coding standards
curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: your_user_id" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "knowsync_query",
"arguments": {
"query": "What are our React component naming conventions and prop validation requirements?",
"mode": "retrieve",
"limit": 4
}
}
}'
KI-Agent-Integration: Konfigurieren Sie Claude Code, um während der Entwicklung sofortigen Zugriff auf die Standards Ihres Teams zu erhalten.
Szenario 2: Onboarding neuer Teammitglieder
Anwendungsfall: Automatisches Befüllen der Wissensdatenbank mit der neuesten Framework-Dokumentation für neue Mitarbeiter.
# Discover and add latest documentation
curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: your_user_id" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "knowsync_manage",
"arguments": {
"operation": "discover",
"query": "Next.js 15 App Router migration guide 2024",
"options": {
"maxResults": 8,
"maxUrls": 4,
"relevanceThreshold": 0.8
}
}
}
}'
Erwartete Antwort mit API-Verbrauch:
{
"success": true,
"documentsCreated": 4,
"apiUnitsConsumed": 8,
"message": "Successfully discovered and processed 4 documents into knowledge base (8 API units consumed)"
}
Hinweis: 4 URLs × 2 Einheiten pro URL (1 Crawl + 1 Verarbeitung) = 8 API-Einheiten insgesamt
Verbesserung des Kundensupports
Szenario 3: Sofortiger Zugriff auf Support-Dokumentation
Anwendungsfall: Support-Agenten erhalten sofortige Antworten aus der Produktdokumentation, während sie Kunden helfen.
# Search for troubleshooting information
curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: support_agent_123" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "knowsync_query",
"arguments": {
"query": "Customer getting 401 errors during payment processing, what are the common causes and solutions?",
"mode": "auto",
"limit": 6
}
}
}'
Vorteile: 60–85 % schnellere Antwortzeit dank Caching, KI-verbessertes Relevanz-Ranking zeigt die hilfreichsten Lösungen zuerst.
Produktmanagement-Workflows
Szenario 4: Wettbewerbsanalyse-Recherche
Anwendungsfall: Produktmanager recherchieren Wettbewerbsfunktionen und Branchentrends.
# Discover latest competitive analysis
curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: product_manager" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "knowsync_manage",
"arguments": {
"operation": "discover",
"query": "SaaS pricing strategy trends 2024 freemium models",
"options": {
"maxResults": 10,
"maxUrls": 5,
"relevanceThreshold": 0.7
}
}
}
}'
Szenario 5: Nachschlagen von Funktionsanforderungen
Anwendungsfall: Schnelles Auffinden vorhandener Funktionsspezifikationen und -anforderungen während der Planung.
# Search existing requirements
curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: product_manager" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 5,
"method": "tools/call",
"params": {
"name": "knowsync_query",
"arguments": {
"query": "user authentication flow requirements two-factor authentication implementation",
"mode": "retrieve",
"filters": {
"contentTypes": ["documents"],
"documentIds": ["spec_docs_collection"]
}
}
}
}'
Vertriebs- und Marketingunterstützung
Szenario 6: Sales Enablement
Anwendungsfall: Das Vertriebsteam greift während Kundenanrufen auf Produktinformationen und Wettbewerbspositionierung zu.
# Quick product feature lookup
curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: sales_rep" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 6,
"method": "tools/call",
"params": {
"name": "knowsync_query",
"arguments": {
"query": "What security certifications do we have? SOC 2 compliance status enterprise security features",
"mode": "search",
"limit": 5
}
}
}'
Wartung der Wissensdatenbank
Szenario 7: Inhaltslücken-Analyse
Anwendungsfall: Ermitteln, welche Dokumentation vorhanden ist und was erstellt werden muss.
# Audit existing documentation
curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: content_manager" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {
"name": "knowsync_manage",
"arguments": {
"operation": "list",
"filters": {
"limit": 50,
"status": "ready",
"contentType": "markdown"
}
}
}
}'
Szenario 8: Hinzufügen von Branchendokumentation
Anwendungsfall: Wissensdatenbank mit den neuesten Branchenstandards und Frameworks aktuell halten.
# Add specific technical documentation
curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: tech_writer" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 8,
"method": "tools/call",
"params": {
"name": "knowsync_manage",
"arguments": {
"operation": "crawl",
"url": "https://nextjs.org/docs/app/building-your-application/authentication",
"options": {
"respectRobots": true,
"timeout": 45,
"followLinks": false
}
}
}
}'
Warum KnowSync MCP revolutionär ist
Der entscheidende Unterschied
Traditionelle Dokumentationssysteme zwingen Sie dazu, nach Informationen zu suchen. KnowSync MCP bringt Informationen zu Ihnen:
Vor KnowSync MCP:
- Zwischen Tools wechseln, um Dokumentation zu durchsuchen
- Wiederholte Suchen für ähnliche Fragen
- Manuelles Zusammenfügen von Informationen aus mehreren Quellen
- 2–5 Sekunden Wartezeit pro Suche
- Ergebnisse, die relevant sein könnten oder auch nicht
Mit KnowSync MCP:
- KI-Agenten greifen automatisch auf Ihre Wissensdatenbank zu
- 60–85 % schnellere Antworten durch intelligentes Caching
- KI versteht den Kontext und liefert genau das, was Sie benötigen
- Sitzungsspeicher erhält den Gesprächskontext
- Ergebnisse werden von der KI für maximale Relevanz sortiert
Echte Auswirkungen auf Ihren Workflow
# Traditional approach: Manual search in documentation
# Time: 2-5 minutes per question
# Result: May not find the right answer
# KnowSync MCP approach: AI agent instantly knows
# Time: 2-5 seconds per question
# Result: Contextual, accurate, source-cited answers
Beispiel: Ein Entwickler, der fragt „Wie handhaben wir die Authentifizierung?", erhält nicht nur die Auth-Dokumentation, sondern gezielt die Abschnitte, die für seinen aktuellen Projektkontext relevant sind, mit Folgeempfehlungen, in unter 2 Sekunden.
Fortgeschrittene Integrationsmuster
Sitzungsbewusste Gespräche
Die KI merkt sich den Kontext über Abfragen in derselben Sitzung und ermöglicht so natürliche Folgefragen:
# First query
curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: developer_session_123" \
-d '{
"params": {
"name": "knowsync_query",
"arguments": {
"query": "How do we handle user authentication in our React apps?"
}
}
}'
# Follow-up query (AI maintains context)
curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: developer_session_123" \
-d '{
"params": {
"name": "knowsync_query",
"arguments": {
"query": "What about logout and session management for that?"
}
}
}'
Beispiele für Leistungsoptimierung
Demonstrieren Sie die Leistungsfähigkeit des intelligenten Cachings:
# First time query (full processing)
time curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: your_user_id" \
-d '{
"params": {
"name": "knowsync_query",
"arguments": {
"query": "deployment pipeline configuration Docker containerization"
}
}
}'
# Response time: ~800ms
# Similar query (cached response)
time curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: your_user_id" \
-d '{
"params": {
"name": "knowsync_query",
"arguments": {
"query": "how to configure deployment pipelines with Docker containers"
}
}
}'
# Response time: ~120ms (85% faster!)
Transformieren Sie die Produktivität Ihres Teams
Vorher vs. Nachher mit KnowSync MCP
| Szenario | Traditionelle Methode | Mit KnowSync MCP | Zeitersparnis | |----------|-------------------|-------------------|------------| | Code-Review | Manuell in Dokumentation suchen | KI-Agent zitiert sofort Codierungsstandards | 90 % schneller | | Kundensupport | Fehlerbehebungsanleitungen nachschlagen | KI liefert exakte Lösungsschritte | 85 % schneller | | Onboarding | Links zur Dokumentation senden | KI beantwortet spezifische Fragen kontextbezogen | 95 % schneller | | Produktplanung | Wettbewerbsfunktionen manuell recherchieren | KI entdeckt und analysiert neueste Trends | 80 % schneller |
Der Verbundeffekt
Woche 1: Ihr Team spart 2–3 Stunden pro Tag bei Dokumentationssuchen Monat 1: 40–60 Stunden pro Teammitglied gespart Jahr 1: Jedes Teammitglied gewinnt 2–3 Wochen produktive Zeit zurück
Echte Nutzererfahrungen
Entwicklungsteam: „Statt 30 Minuten mit der Suche nach unseren API-Mustern zu verbringen, zeigt mir Claude Code sofort genau das, was ich brauche. Ich kann mich auf das Bauen konzentrieren, statt zu suchen."
Support-Team: „Kundenanfragen, für die wir früher 10 Minuten Recherche brauchten, werden jetzt in 30 Sekunden beantwortet. Unsere Antwortqualität hat sich verbessert, während unsere Antwortzeit drastisch gesunken ist."
Produktteam: „Recherchen, die früher Stunden dauerten, erledigen wir jetzt in Minuten. Wir können Wettbewerbsfunktionen analysieren, Anforderungen finden und Entscheidungen schneller als je zuvor treffen."
Der Einstieg ist einfach
- API-Schlüssel erstellen (2 Minuten)
- KI-Agent verbinden (Claude, Cursor, VS Code)
- Fragen stellen – das war's!
Die Stärke liegt nicht in der Technologie – sondern darin, wie sie Ihre tägliche Arbeit vom Suchen zum Erstellen transformiert.
Nutzungsanalysen und Überwachung
MCP-Dashboard-Funktionen
API-Schlüssel-Verwaltung:
- API-Schlüssel erstellen, bearbeiten und löschen
- Nutzungsstatistiken pro Schlüssel überwachen
- Berechtigungen und Ratenlimits konfigurieren
- Anforderungsverlauf und -muster anzeigen
Nutzungsanalysen:
- Echtzeit-Anforderungsmetriken nach Tool
- Erfolgs-/Fehlerraten und Antwortzeiten
- Pro-Benutzer-Zuordnung und Team-Einblicke
- Historische Trends und Nutzungsmuster
Einstellungskonfiguration:
- Web-Crawling-Limits und Timeout-Einstellungen
- Domain-Zulassungs-/Blockierlisten für Web-Discovery
- Präferenzen für Inhaltsfilterung
- Ratenbegrenzung und Sicherheitskontrollen
Team-Nutzungsverfolgung
Einzelanalysen:
- Verfolgen, welche Teammitglieder MCP-Tools verwenden
- Übernahme-Muster in der gesamten Organisation überwachen
- Power-User und Schulungsbedarf identifizieren
- Nutzungsberichte für das Management erstellen
Anforderungszuordnung: Alle MCP-Anfragen erfordern Benutzeridentifikations-Header:
- X-User-Id: Direkte Benutzer-ID-Zuordnung
- X-User-Email: E-Mail-basierte Benutzerzuordnung
- Anfragen ohne Benutzer-Header werden abgelehnt
- Vollständiger Prüfpfad für Compliance
Sicherheit und Zugriffskontrolle
Authentifizierungssystem
API-Schlüssel-Sicherheit:
- Bcrypt-Hashing für gespeicherte Schlüssel
- Automatische Schlüsselrotation-Funktionen
- Ratenbegrenzung pro Schlüssel zur Missbrauchsverhinderung
- Echtzeitüberwachung auf verdächtige Aktivitäten
Berechtigungsmodell:
- Tool-Ebenen-Berechtigungen (granulare Zugriffskontrolle)
- Organisationsbasierte Zugriffsbeschränkungen
- Planbasierte Funktionsverfügbarkeit
- Benutzerdefinierte Berechtigungskombinationen
Enterprise-Sicherheit (Enterprise-Pläne)
Erweiterte Funktionen:
- IP-basierte Zugriffsbeschränkungen
- Single Sign-On (SSO)-Integration
- Audit-Logs für Compliance-Anforderungen
- Benutzerdefinierte Sicherheitsrichtlinien und -kontrollen
Datenschutz:
- TLS-Verschlüsselung für die gesamte Kommunikation
- Sichere Speicherung von API-Schlüsseln und Benutzerdaten
- DSGVO- und CCPA-Konformitätsfunktionen
- Regelmäßige Sicherheitsaudits und Updates
Fehlerbehebung
Häufige Probleme
Verbindungsprobleme:
- Fehler: Der KI-Agent kann keine Verbindung zum MCP-Server herstellen
- Lösungen:
- Überprüfen Sie, ob der API-Schlüssel korrekt ist und nicht abgelaufen ist
- Bestätigen Sie, dass Ihre Domain-URL erreichbar ist (nicht localhost für Remote-Tools)
- Stellen Sie sicher, dass Benutzeridentifikations-Header enthalten sind
- Überprüfen Sie die Berechtigungen des API-Schlüssels für die erforderlichen Tools
- Überprüfen Sie, ob der API-Schlüssel korrekt ist und nicht abgelaufen ist
Authentifizierungsfehler:
- Fehler: „Nicht autorisiert" oder „Benutzeridentifikation erforderlich"
- Lösungen:
- Fügen Sie den X-User-Id- oder X-User-Email-Header in alle Anfragen ein
- Überprüfen Sie, ob die Benutzer-ID/E-Mail in Ihrer Organisation existiert
- Generieren Sie den API-Schlüssel bei Bedarf neu
- Überprüfen Sie, ob der API-Schlüssel über die entsprechenden Tool-Berechtigungen verfügt
- Fügen Sie den X-User-Id- oder X-User-Email-Header in alle Anfragen ein
Ratenbegrenzung:
- Fehler: „Ratenlimit überschritten"
- Lösungen:
- Überprüfen Sie die aktuelle Nutzung im MCP-Dashboard
- Passen Sie die Ratenlimits für Ihren API-Schlüssel an
- Erwägen Sie ein Upgrade Ihres Tarifs für höhere Limits
- Implementieren Sie Anforderungsdrosselung in Ihrer Anwendung
- Überprüfen Sie die aktuelle Nutzung im MCP-Dashboard
Tool-Berechtigungsfehler:
- Fehler: „Zugriff für Tool X verweigert"
- Lösungen:
- Bearbeiten Sie die API-Schlüssel-Berechtigungen im MCP-Dashboard
- Stellen Sie sicher, dass Ihr Tarif Zugriff auf erweiterte Tools beinhaltet
- Kontaktieren Sie den Support für tarifspezifische Einschränkungen
- Bearbeiten Sie die API-Schlüssel-Berechtigungen im MCP-Dashboard
Testen Ihres MCP-Servers
Gesundheitscheck:
# Test server connectivity
curl https://www.knowsync.ai/api/mcp
# Expected response includes server info and available tools
Tool-Tests:
# Test initialize method
curl -X POST https://www.knowsync.ai/api/mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "X-User-Id: your_user_id" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"capabilities": {"tools": true},
"clientInfo": {"name": "test-client", "version": "1.0.0"}
}
}'
Zukünftige MCP-Tools
KnowSync entwickelt aktiv weitere MCP-Tools, die für 2025 geplant sind:
Phase 1 (Q1 2025):
- knowsync_summarize: Intelligente Zusammenfassungen von Dokumenten erstellen
- knowsync_bulk_operations: Stapeloperationen für mehrere Dokumente durchführen
- knowsync_compare: Dokumente auf Ähnlichkeiten und Unterschiede vergleichen
Phase 2 (Q2 2025):
- knowsync_analytics: Nutzungseinblicke und Wissensdatenbank-Analysen erhalten
- knowsync_quality_check: Inhaltsqualität analysieren und verbessern
Weitere Details finden Sie in unserer MCP-Tools-Roadmap.
Support erhalten
Dokumentation:
- Vollständiger MCP-Testleitfaden mit Praxisbeispielen
- API-Referenzdokumentation für alle Tools
- Integrationsanleitungen für gängige KI-Plattformen
Support-Kanäle:
- Starter/Professional: E-Mail-Support mit MCP-Expertise
- Enterprise: Dedizierter MCP-Integrationssupport
- Alle Tarife: Community-Foren und Dokumentation
Benutzerdefinierte Integration: Enterprise-Kunden können mit unserem Team an der Entwicklung benutzerdefinierter MCP-Tools und fortschrittlicher Integrationsmuster arbeiten.
🚀 Bereit, Ihre KI-Tools zu verbinden?
Beginnen Sie mit der Erstellung Ihres ersten API-Schlüssels im MCP-Dashboard und testen Sie dann die Verbindung mit einer einfachen Suchanfrage. Denken Sie daran, Benutzeridentifikations-Header für die korrekte Team-Zuordnung einzufügen.