feat(i18n): update translations (#2645)

Co-authored-by: waleedlatif1 <waleedlatif1@users.noreply.github.com>
This commit is contained in:
Waleed
2025-12-30 19:50:11 -08:00
committed by GitHub
parent 2cfd75a422
commit 776f82c0a6
11 changed files with 784 additions and 209 deletions

View File

@@ -0,0 +1,108 @@
---
title: Workflows als MCP bereitstellen
description: Stellen Sie Ihre Workflows als MCP-Tools für externe KI-Assistenten
und Anwendungen bereit
---
import { Video } from '@/components/ui/video'
import { Callout } from 'fumadocs-ui/components/callout'
Stellen Sie Ihre Workflows als MCP-Tools bereit, um sie für externe KI-Assistenten wie Claude Desktop, Cursor und andere MCP-kompatible Clients zugänglich zu machen. Dies verwandelt Ihre Workflows in aufrufbare Tools, die von überall aus aufgerufen werden können.
## MCP-Server erstellen und verwalten
MCP-Server gruppieren Ihre Workflow-Tools zusammen. Erstellen und verwalten Sie sie in den Workspace-Einstellungen:
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/mcp-server.mp4" width={700} height={450} />
</div>
1. Navigieren Sie zu **Einstellungen → MCP-Server**
2. Klicken Sie auf **Server erstellen**
3. Geben Sie einen Namen und eine optionale Beschreibung ein
4. Kopieren Sie die Server-URL zur Verwendung in Ihren MCP-Clients
5. Zeigen Sie alle zum Server hinzugefügten Tools an und verwalten Sie diese
## Einen Workflow als Tool hinzufügen
Sobald Ihr Workflow bereitgestellt ist, können Sie ihn als MCP-Tool verfügbar machen:
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/mcp-deploy-tool.mp4" width={700} height={450} />
</div>
1. Öffnen Sie Ihren bereitgestellten Workflow
2. Klicken Sie auf **Bereitstellen** und wechseln Sie zum Tab **MCP**
3. Konfigurieren Sie den Tool-Namen und die Beschreibung
4. Fügen Sie Beschreibungen für jeden Parameter hinzu (hilft der KI, Eingaben zu verstehen)
5. Wählen Sie aus, zu welchen MCP-Servern es hinzugefügt werden soll
<Callout type="info">
Der Workflow muss bereitgestellt sein, bevor er als MCP-Tool hinzugefügt werden kann.
</Callout>
## Tool-Konfiguration
### Tool-Name
Verwenden Sie Kleinbuchstaben, Zahlen und Unterstriche. Der Name sollte beschreibend sein und den MCP-Namenskonventionen folgen (z. B. `search_documents`, `send_email`).
### Beschreibung
Schreiben Sie eine klare Beschreibung dessen, was das Tool tut. Dies hilft KI-Assistenten zu verstehen, wann das Tool verwendet werden soll.
### Parameter
Die Eingabeformatfelder deines Workflows werden zu Tool-Parametern. Füge jedem Parameter Beschreibungen hinzu, um KI-Assistenten zu helfen, korrekte Werte bereitzustellen.
## MCP-Clients verbinden
Verwende die Server-URL aus den Einstellungen, um externe Anwendungen zu verbinden:
### Claude Desktop
Füge dies zu deiner Claude Desktop-Konfiguration hinzu (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"my-sim-workflows": {
"command": "npx",
"args": ["-y", "mcp-remote", "YOUR_SERVER_URL"]
}
}
}
```
### Cursor
Füge die Server-URL in den MCP-Einstellungen von Cursor mit demselben mcp-remote-Muster hinzu.
<Callout type="warn">
Füge deinen API-Key-Header (`X-API-Key`) für authentifizierten Zugriff hinzu, wenn du mcp-remote oder andere HTTP-basierte MCP-Transporte verwendest.
</Callout>
## Server-Verwaltung
In der Server-Detailansicht unter **Einstellungen → MCP-Server** kannst du:
- **Tools anzeigen**: Alle Workflows sehen, die einem Server hinzugefügt wurden
- **URL kopieren**: Die Server-URL für MCP-Clients abrufen
- **Workflows hinzufügen**: Weitere bereitgestellte Workflows als Tools hinzufügen
- **Tools entfernen**: Workflows vom Server entfernen
- **Server löschen**: Den gesamten Server und alle seine Tools entfernen
## So funktioniert es
Wenn ein MCP-Client dein Tool aufruft:
1. Die Anfrage wird an deiner MCP-Server-URL empfangen
2. Sim validiert die Anfrage und ordnet Parameter den Workflow-Eingaben zu
3. Der bereitgestellte Workflow wird mit den angegebenen Eingaben ausgeführt
4. Die Ergebnisse werden an den MCP-Client zurückgegeben
Workflows werden mit derselben Bereitstellungsversion wie API-Aufrufe ausgeführt, was konsistentes Verhalten gewährleistet.
## Berechtigungsanforderungen
| Aktion | Erforderliche Berechtigung |
|--------|-------------------|
| MCP-Server erstellen | **Admin** |
| Workflows zu Servern hinzufügen | **Write** oder **Admin** |
| MCP-Server anzeigen | **Read**, **Write** oder **Admin** |
| MCP-Server löschen | **Admin** |

View File

@@ -1,8 +1,10 @@
---
title: MCP (Model Context Protocol)
title: MCP-Tools verwenden
description: Externe Tools und Dienste über das Model Context Protocol verbinden
---
import { Image } from '@/components/ui/image'
import { Video } from '@/components/ui/video'
import { Callout } from 'fumadocs-ui/components/callout'
Das Model Context Protocol ([MCP](https://modelcontextprotocol.com/)) ermöglicht es Ihnen, externe Tools und Dienste über ein standardisiertes Protokoll zu verbinden, wodurch Sie APIs und Dienste direkt in Ihre Workflows integrieren können. Mit MCP können Sie die Fähigkeiten von Sim erweitern, indem Sie benutzerdefinierte Integrationen hinzufügen, die nahtlos mit Ihren Agenten und Workflows zusammenarbeiten.
@@ -20,14 +22,8 @@ MCP ist ein offener Standard, der es KI-Assistenten ermöglicht, sich sicher mit
MCP-Server stellen Sammlungen von Tools bereit, die Ihre Agenten nutzen können. Konfigurieren Sie diese in den Workspace-Einstellungen:
<div className="flex justify-center">
<Image
src="/static/blocks/mcp-1.png"
alt="Konfiguration eines MCP-Servers in den Einstellungen"
width={700}
height={450}
className="my-6"
/>
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/settings-mcp-tools.mp4" width={700} height={450} />
</div>
1. Navigieren Sie zu Ihren Workspace-Einstellungen
@@ -40,14 +36,18 @@ MCP-Server stellen Sammlungen von Tools bereit, die Ihre Agenten nutzen können.
Sie können MCP-Server auch direkt über die Symbolleiste in einem Agent-Block für eine schnelle Einrichtung konfigurieren.
</Callout>
## Verwendung von MCP-Tools in Agenten
### Tools aktualisieren
Sobald MCP-Server konfiguriert sind, werden ihre Tools innerhalb Ihrer Agent-Blöcke verfügbar:
Klicken Sie bei einem Server auf **Aktualisieren**, um die neuesten Tool-Schemas abzurufen und alle Agent-Blöcke, die diese Tools verwenden, automatisch mit den neuen Parameterdefinitionen zu aktualisieren.
## MCP-Tools in Agents verwenden
Sobald MCP-Server konfiguriert sind, werden ihre Tools in Ihren Agent-Blöcken verfügbar:
<div className="flex justify-center">
<Image
src="/static/blocks/mcp-2.png"
alt="Verwendung eines MCP-Tools im Agent-Block"
alt="Using MCP Tool in Agent Block"
width={700}
height={450}
className="my-6"
@@ -55,25 +55,25 @@ Sobald MCP-Server konfiguriert sind, werden ihre Tools innerhalb Ihrer Agent-Bl
</div>
1. Öffnen Sie einen **Agent**-Block
2. Im Abschnitt **Tools** sehen Sie die verfügbaren MCP-Tools
2. Im Bereich **Tools** sehen Sie die verfügbaren MCP-Tools
3. Wählen Sie die Tools aus, die der Agent verwenden soll
4. Der Agent kann nun während der Ausführung auf diese Tools zugreifen
## Eigenständiger MCP-Tool-Block
Für eine genauere Kontrolle können Sie den dedizierten MCP-Tool-Block verwenden, um bestimmte MCP-Tools auszuführen:
Für eine präzisere Steuerung können Sie den dedizierten MCP-Tool-Block verwenden, um bestimmte MCP-Tools auszuführen:
<div className="flex justify-center">
<Image
src="/static/blocks/mcp-3.png"
alt="Eigenständiger MCP-Tool-Block"
alt="Standalone MCP Tool Block"
width={700}
height={450}
className="my-6"
/>
</div>
Der MCP-Tool-Block ermöglicht es Ihnen:
Der MCP-Tool-Block ermöglicht Ihnen:
- Jedes konfigurierte MCP-Tool direkt auszuführen
- Spezifische Parameter an das Tool zu übergeben
- Die Ausgabe des Tools in nachfolgenden Workflow-Schritten zu verwenden
@@ -81,9 +81,9 @@ Der MCP-Tool-Block ermöglicht es Ihnen:
### Wann MCP-Tool vs. Agent verwenden
**Verwenden Sie einen Agenten mit MCP-Tools, wenn:**
- Sie möchten, dass die KI entscheidet, welche Tools zu verwenden sind
- Sie komplexe Überlegungen benötigen, wann und wie Tools eingesetzt werden sollen
**Verwenden Sie Agent mit MCP-Tools, wenn:**
- Sie möchten, dass die KI entscheidet, welche Tools verwendet werden
- Sie komplexes Reasoning darüber benötigen, wann und wie Tools verwendet werden
- Sie eine natürlichsprachliche Interaktion mit den Tools wünschen
**Verwenden Sie den MCP-Tool-Block, wenn:**
@@ -93,7 +93,7 @@ Der MCP-Tool-Block ermöglicht es Ihnen:
## Berechtigungsanforderungen
MCP-Funktionalität erfordert spezifische Workspace-Berechtigungen:
Die MCP-Funktionalität erfordert spezifische Workspace-Berechtigungen:
| Aktion | Erforderliche Berechtigung |
|--------|-------------------|
@@ -105,7 +105,7 @@ MCP-Funktionalität erfordert spezifische Workspace-Berechtigungen:
## Häufige Anwendungsfälle
### Datenbankintegration
Verbinden Sie sich mit Datenbanken, um Daten innerhalb Ihrer Workflows abzufragen, einzufügen oder zu aktualisieren.
Verbinden Sie sich mit Datenbanken, um Daten in Ihren Workflows abzufragen, einzufügen oder zu aktualisieren.
### API-Integrationen
Greifen Sie auf externe APIs und Webdienste zu, die keine integrierten Sim-Integrationen haben.
@@ -113,8 +113,8 @@ Greifen Sie auf externe APIs und Webdienste zu, die keine integrierten Sim-Integ
### Dateisystemzugriff
Lesen, schreiben und bearbeiten Sie Dateien auf lokalen oder entfernten Dateisystemen.
### Benutzerdefinierte Geschäftslogik
Führen Sie benutzerdefinierte Skripte oder Tools aus, die auf die Bedürfnisse Ihrer Organisation zugeschnitten sind.
### Individuelle Geschäftslogik
Führen Sie benutzerdefinierte Skripte oder Tools aus, die spezifisch für die Anforderungen Ihrer Organisation sind.
### Echtzeit-Datenzugriff
Rufen Sie Live-Daten von externen Systemen während der Workflow-Ausführung ab.
@@ -128,12 +128,12 @@ Rufen Sie Live-Daten von externen Systemen während der Workflow-Ausführung ab.
## Fehlerbehebung
### MCP-Server erscheint nicht
### MCP-Server wird nicht angezeigt
- Überprüfen Sie, ob die Serverkonfiguration korrekt ist
- Prüfen Sie, ob Sie die erforderlichen Berechtigungen haben
- Stellen Sie sicher, dass der MCP-Server läuft und zugänglich ist
- Prüfen Sie, ob Sie über die erforderlichen Berechtigungen verfügen
- Stellen Sie sicher, dass der MCP-Server läuft und erreichbar ist
### Fehler bei der Tool-Ausführung
### Tool-Ausführungsfehler
- Überprüfen Sie, ob die Tool-Parameter korrekt formatiert sind
- Prüfen Sie die MCP-Server-Logs auf Fehlermeldungen
- Stellen Sie sicher, dass die erforderliche Authentifizierung konfiguriert ist
@@ -141,4 +141,4 @@ Rufen Sie Live-Daten von externen Systemen während der Workflow-Ausführung ab.
### Berechtigungsfehler
- Bestätigen Sie Ihre Workspace-Berechtigungsstufe
- Prüfen Sie, ob der MCP-Server zusätzliche Authentifizierung erfordert
- Stellen Sie sicher, dass der Server für Ihren Workspace richtig konfiguriert ist
- Überprüfen Sie, ob der Server ordnungsgemäß für Ihren Workspace konfiguriert ist

View File

@@ -0,0 +1,108 @@
---
title: Implementar flujos de trabajo como MCP
description: Expone tus flujos de trabajo como herramientas MCP para asistentes
de IA externos y aplicaciones
---
import { Video } from '@/components/ui/video'
import { Callout } from 'fumadocs-ui/components/callout'
Implementa tus flujos de trabajo como herramientas MCP para hacerlos accesibles a asistentes de IA externos como Claude Desktop, Cursor y otros clientes compatibles con MCP. Esto convierte tus flujos de trabajo en herramientas invocables que pueden ser llamadas desde cualquier lugar.
## Crear y gestionar servidores MCP
Los servidores MCP agrupan tus herramientas de flujo de trabajo. Créalos y gestiόnalos en la configuración del espacio de trabajo:
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/mcp-server.mp4" width={700} height={450} />
</div>
1. Navega a **Configuración → Servidores MCP**
2. Haz clic en **Crear servidor**
3. Introduce un nombre y una descripción opcional
4. Copia la URL del servidor para usarla en tus clientes MCP
5. Visualiza y gestiona todas las herramientas añadidas al servidor
## Añadir un flujo de trabajo como herramienta
Una vez que tu flujo de trabajo esté implementado, puedes exponerlo como una herramienta MCP:
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/mcp-deploy-tool.mp4" width={700} height={450} />
</div>
1. Abre tu flujo de trabajo implementado
2. Haz clic en **Implementar** y ve a la pestaña **MCP**
3. Configura el nombre y la descripción de la herramienta
4. Añade descripciones para cada parámetro (ayuda a la IA a entender las entradas)
5. Selecciona a qué servidores MCP añadirla
<Callout type="info">
El flujo de trabajo debe estar implementado antes de poder añadirse como herramienta MCP.
</Callout>
## Configuración de la herramienta
### Nombre de la herramienta
Usa letras minúsculas, números y guiones bajos. El nombre debe ser descriptivo y seguir las convenciones de nomenclatura de MCP (por ejemplo, `search_documents`, `send_email`).
### Descripción
Escribe una descripción clara de lo que hace la herramienta. Esto ayuda a los asistentes de IA a entender cuándo usar la herramienta.
### Parámetros
Los campos de formato de entrada de tu flujo de trabajo se convierten en parámetros de herramienta. Añade descripciones a cada parámetro para ayudar a los asistentes de IA a proporcionar valores correctos.
## Conectar clientes MCP
Usa la URL del servidor desde la configuración para conectar aplicaciones externas:
### Claude Desktop
Añade a tu configuración de Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
"mcpServers": {
"my-sim-workflows": {
"command": "npx",
"args": ["-y", "mcp-remote", "YOUR_SERVER_URL"]
}
}
}
```
### Cursor
Añade la URL del servidor en la configuración MCP de Cursor usando el mismo patrón mcp-remote.
<Callout type="warn">
Incluye tu encabezado de clave API (`X-API-Key`) para acceso autenticado al usar mcp-remote u otros transportes MCP basados en HTTP.
</Callout>
## Gestión del servidor
Desde la vista de detalle del servidor en **Configuración → Servidores MCP**, puedes:
- **Ver herramientas**: consulta todos los flujos de trabajo añadidos a un servidor
- **Copiar URL**: obtén la URL del servidor para clientes MCP
- **Añadir flujos de trabajo**: añade más flujos de trabajo desplegados como herramientas
- **Eliminar herramientas**: elimina flujos de trabajo del servidor
- **Eliminar servidor**: elimina el servidor completo y todas sus herramientas
## Cómo funciona
Cuando un cliente MCP llama a tu herramienta:
1. La solicitud se recibe en la URL de tu servidor MCP
2. Sim valida la solicitud y mapea los parámetros a las entradas del flujo de trabajo
3. El flujo de trabajo desplegado se ejecuta con las entradas proporcionadas
4. Los resultados se devuelven al cliente MCP
Los flujos de trabajo se ejecutan usando la misma versión de despliegue que las llamadas API, garantizando un comportamiento consistente.
## Requisitos de permisos
| Acción | Permiso requerido |
|--------|-------------------|
| Crear servidores MCP | **Admin** |
| Añadir flujos de trabajo a servidores | **Write** o **Admin** |
| Ver servidores MCP | **Read**, **Write** o **Admin** |
| Eliminar servidores MCP | **Admin** |

View File

@@ -1,8 +1,10 @@
---
title: MCP (Protocolo de Contexto de Modelo)
title: Uso de herramientas MCP
description: Conecta herramientas y servicios externos usando el Model Context Protocol
---
import { Image } from '@/components/ui/image'
import { Video } from '@/components/ui/video'
import { Callout } from 'fumadocs-ui/components/callout'
El Protocolo de Contexto de Modelo ([MCP](https://modelcontextprotocol.com/)) te permite conectar herramientas y servicios externos utilizando un protocolo estandarizado, permitiéndote integrar APIs y servicios directamente en tus flujos de trabajo. Con MCP, puedes ampliar las capacidades de Sim añadiendo integraciones personalizadas que funcionan perfectamente con tus agentes y flujos de trabajo.
@@ -20,14 +22,8 @@ MCP es un estándar abierto que permite a los asistentes de IA conectarse de for
Los servidores MCP proporcionan colecciones de herramientas que tus agentes pueden utilizar. Configúralos en los ajustes del espacio de trabajo:
<div className="flex justify-center">
<Image
src="/static/blocks/mcp-1.png"
alt="Configuración del servidor MCP en Ajustes"
width={700}
height={450}
className="my-6"
/>
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/settings-mcp-tools.mp4" width={700} height={450} />
</div>
1. Navega a los ajustes de tu espacio de trabajo
@@ -40,14 +36,18 @@ Los servidores MCP proporcionan colecciones de herramientas que tus agentes pued
También puedes configurar servidores MCP directamente desde la barra de herramientas en un bloque de Agente para una configuración rápida.
</Callout>
### Actualizar herramientas
Haz clic en **Actualizar** en un servidor para obtener los esquemas de herramientas más recientes y actualizar automáticamente cualquier bloque de agente que use esas herramientas con las nuevas definiciones de parámetros.
## Uso de herramientas MCP en agentes
Una vez que los servidores MCP están configurados, sus herramientas estarán disponibles dentro de tus bloques de agente:
Una vez configurados los servidores MCP, sus herramientas están disponibles dentro de tus bloques de agente:
<div className="flex justify-center">
<Image
src="/static/blocks/mcp-2.png"
alt="Uso de herramienta MCP en bloque de Agente"
alt="Uso de herramienta MCP en bloque de agente"
width={700}
height={450}
className="my-6"
@@ -61,7 +61,7 @@ Una vez que los servidores MCP están configurados, sus herramientas estarán di
## Bloque de herramienta MCP independiente
Para un control más preciso, puedes usar el bloque dedicado de Herramienta MCP para ejecutar herramientas MCP específicas:
Para un control más granular, puedes usar el bloque de herramienta MCP dedicado para ejecutar herramientas MCP específicas:
<div className="flex justify-center">
<Image
@@ -73,23 +73,23 @@ Para un control más preciso, puedes usar el bloque dedicado de Herramienta MCP
/>
</div>
El bloque de Herramienta MCP te permite:
El bloque de herramienta MCP te permite:
- Ejecutar cualquier herramienta MCP configurada directamente
- Pasar parámetros específicos a la herramienta
- Usar la salida de la herramienta en pasos posteriores del flujo de trabajo
- Encadenar múltiples herramientas MCP
### Cuándo usar Herramienta MCP vs Agente
### Cuándo usar herramienta MCP vs. agente
**Usa Agente con herramientas MCP cuando:**
**Usa agente con herramientas MCP cuando:**
- Quieres que la IA decida qué herramientas usar
- Necesitas un razonamiento complejo sobre cuándo y cómo usar las herramientas
- Deseas una interacción en lenguaje natural con las herramientas
- Necesitas razonamiento complejo sobre cuándo y cómo usar las herramientas
- Quieres interacción en lenguaje natural con las herramientas
**Usa el bloque Herramienta MCP cuando:**
- Necesites una ejecución determinista de herramientas
- Quieras ejecutar una herramienta específica con parámetros conocidos
- Estés construyendo flujos de trabajo estructurados con pasos predecibles
- Necesitas una ejecución determinista de herramientas
- Quieres ejecutar una herramienta específica con parámetros conocidos
- Estás construyendo flujos de trabajo estructurados con pasos predecibles
## Requisitos de permisos
@@ -99,22 +99,22 @@ La funcionalidad MCP requiere permisos específicos del espacio de trabajo:
|--------|-------------------|
| Configurar servidores MCP en ajustes | **Admin** |
| Usar herramientas MCP en agentes | **Write** o **Admin** |
| Ver herramientas MCP disponibles | **Read**, **Write**, o **Admin** |
| Ver herramientas MCP disponibles | **Read**, **Write** o **Admin** |
| Ejecutar bloques de Herramienta MCP | **Write** o **Admin** |
## Casos de uso comunes
### Integración con bases de datos
Conéctate a bases de datos para consultar, insertar o actualizar datos dentro de tus flujos de trabajo.
Conecta con bases de datos para consultar, insertar o actualizar datos dentro de tus flujos de trabajo.
### Integraciones de API
Accede a APIs externas y servicios web que no tienen integraciones incorporadas en Sim.
Accede a API externas y servicios web que no tienen integraciones integradas en Sim.
### Acceso al sistema de archivos
Lee, escribe y manipula archivos en sistemas de archivos locales o remotos.
### Lógica de negocio personalizada
Ejecuta scripts o herramientas personalizadas específicas para las necesidades de tu organización.
Ejecuta scripts o herramientas personalizadas específicas de las necesidades de tu organización.
### Acceso a datos en tiempo real
Obtén datos en vivo de sistemas externos durante la ejecución del flujo de trabajo.
@@ -122,23 +122,23 @@ Obtén datos en vivo de sistemas externos durante la ejecución del flujo de tra
## Consideraciones de seguridad
- Los servidores MCP se ejecutan con los permisos del usuario que los configuró
- Verifica siempre las fuentes del servidor MCP antes de la instalación
- Siempre verifica las fuentes de los servidores MCP antes de la instalación
- Usa variables de entorno para datos de configuración sensibles
- Revisa las capacidades del servidor MCP antes de conceder acceso a los agentes
- Revisa las capacidades del servidor MCP antes de otorgar acceso a los agentes
## Solución de problemas
### El servidor MCP no aparece
- Verifica que la configuración del servidor sea correcta
- Comprueba que tienes los permisos necesarios
- Asegúrate de que el servidor MCP esté en funcionamiento y sea accesible
- Comprueba que tienes los permisos requeridos
- Asegúrate de que el servidor MCP esté en ejecución y accesible
### Fallos en la ejecución de herramientas
- Verifica que los parámetros de la herramienta estén correctamente formateados
- Revisa los registros del servidor MCP para ver mensajes de error
- Revisa los registros del servidor MCP para mensajes de error
- Asegúrate de que la autenticación requerida esté configurada
### Errores de permisos
- Confirma tu nivel de permisos en el espacio de trabajo
- Comprueba si el servidor MCP requiere autenticación adicional
- Verifica que el servidor esté configurado correctamente para tu espacio de trabajo
- Confirma tu nivel de permisos del espacio de trabajo
- Verifica si el servidor MCP requiere autenticación adicional
- Comprueba que el servidor esté configurado correctamente para tu espacio de trabajo

View File

@@ -0,0 +1,108 @@
---
title: Déployer des workflows en tant que MCP
description: Exposez vos workflows en tant qu'outils MCP pour les assistants IA
externes et les applications
---
import { Video } from '@/components/ui/video'
import { Callout } from 'fumadocs-ui/components/callout'
Déployez vos workflows en tant qu'outils MCP pour les rendre accessibles aux assistants IA externes comme Claude Desktop, Cursor et autres clients compatibles MCP. Cela transforme vos workflows en outils appelables qui peuvent être invoqués depuis n'importe où.
## Créer et gérer des serveurs MCP
Les serveurs MCP regroupent vos outils de workflow. Créez-les et gérez-les dans les paramètres de l'espace de travail :
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/mcp-server.mp4" width={700} height={450} />
</div>
1. Accédez à **Paramètres → Serveurs MCP**
2. Cliquez sur **Créer un serveur**
3. Saisissez un nom et une description facultative
4. Copiez l'URL du serveur pour l'utiliser dans vos clients MCP
5. Consultez et gérez tous les outils ajoutés au serveur
## Ajouter un workflow en tant qu'outil
Une fois votre workflow déployé, vous pouvez l'exposer en tant qu'outil MCP :
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/mcp-deploy-tool.mp4" width={700} height={450} />
</div>
1. Ouvrez votre workflow déployé
2. Cliquez sur **Déployer** et accédez à l'onglet **MCP**
3. Configurez le nom et la description de l'outil
4. Ajoutez des descriptions pour chaque paramètre (aide l'IA à comprendre les entrées)
5. Sélectionnez les serveurs MCP auxquels l'ajouter
<Callout type="info">
Le workflow doit être déployé avant de pouvoir être ajouté en tant qu'outil MCP.
</Callout>
## Configuration de l'outil
### Nom de l'outil
Utilisez des lettres minuscules, des chiffres et des traits de soulignement. Le nom doit être descriptif et suivre les conventions de nommage MCP (par exemple, `search_documents`, `send_email`).
### Description
Rédigez une description claire de ce que fait l'outil. Cela aide les assistants IA à comprendre quand utiliser l'outil.
### Paramètres
Les champs du format d'entrée de votre workflow deviennent des paramètres d'outil. Ajoutez des descriptions à chaque paramètre pour aider les assistants IA à fournir les valeurs correctes.
## Connexion des clients MCP
Utilisez l'URL du serveur depuis les paramètres pour connecter des applications externes :
### Claude Desktop
Ajoutez à votre configuration Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`) :
```json
{
"mcpServers": {
"my-sim-workflows": {
"command": "npx",
"args": ["-y", "mcp-remote", "YOUR_SERVER_URL"]
}
}
}
```
### Cursor
Ajoutez l'URL du serveur dans les paramètres MCP de Cursor en utilisant le même modèle mcp-remote.
<Callout type="warn">
Incluez votre en-tête de clé API (`X-API-Key`) pour un accès authentifié lors de l'utilisation de mcp-remote ou d'autres transports MCP basés sur HTTP.
</Callout>
## Gestion du serveur
Depuis la vue détaillée du serveur dans **Paramètres → Serveurs MCP**, vous pouvez :
- **Voir les outils** : voir tous les workflows ajoutés à un serveur
- **Copier l'URL** : obtenir l'URL du serveur pour les clients MCP
- **Ajouter des workflows** : ajouter d'autres workflows déployés comme outils
- **Supprimer des outils** : retirer des workflows du serveur
- **Supprimer le serveur** : supprimer l'intégralité du serveur et tous ses outils
## Comment ça fonctionne
Lorsqu'un client MCP appelle votre outil :
1. La requête est reçue à l'URL de votre serveur MCP
2. Sim valide la requête et mappe les paramètres aux entrées du workflow
3. Le workflow déployé s'exécute avec les entrées fournies
4. Les résultats sont renvoyés au client MCP
Les workflows s'exécutent en utilisant la même version de déploiement que les appels API, garantissant un comportement cohérent.
## Exigences de permission
| Action | Permission requise |
|--------|-------------------|
| Créer des serveurs MCP | **Admin** |
| Ajouter des workflows aux serveurs | **Write** ou **Admin** |
| Voir les serveurs MCP | **Read**, **Write** ou **Admin** |
| Supprimer des serveurs MCP | **Admin** |

View File

@@ -1,8 +1,11 @@
---
title: MCP (Model Context Protocol)
title: Utiliser les outils MCP
description: Connectez des outils et services externes en utilisant le Model
Context Protocol
---
import { Image } from '@/components/ui/image'
import { Video } from '@/components/ui/video'
import { Callout } from 'fumadocs-ui/components/callout'
Le Model Context Protocol ([MCP](https://modelcontextprotocol.com/)) vous permet de connecter des outils et services externes en utilisant un protocole standardisé, vous permettant d'intégrer des API et des services directement dans vos flux de travail. Avec MCP, vous pouvez étendre les capacités de Sim en ajoutant des intégrations personnalisées qui fonctionnent parfaitement avec vos agents et flux de travail.
@@ -20,14 +23,8 @@ MCP est une norme ouverte qui permet aux assistants IA de se connecter de maniè
Les serveurs MCP fournissent des collections d'outils que vos agents peuvent utiliser. Configurez-les dans les paramètres de l'espace de travail :
<div className="flex justify-center">
<Image
src="/static/blocks/mcp-1.png"
alt="Configuration du serveur MCP dans les paramètres"
width={700}
height={450}
className="my-6"
/>
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/settings-mcp-tools.mp4" width={700} height={450} />
</div>
1. Accédez aux paramètres de votre espace de travail
@@ -40,14 +37,18 @@ Les serveurs MCP fournissent des collections d'outils que vos agents peuvent uti
Vous pouvez également configurer les serveurs MCP directement depuis la barre d'outils d'un bloc Agent pour une configuration rapide.
</Callout>
## Utilisation des outils MCP dans les agents
### Actualiser les outils
Une fois les serveurs MCP configurés, leurs outils deviennent disponibles dans vos blocs d'agents :
Cliquez sur **Actualiser** sur un serveur pour récupérer les derniers schémas d'outils et mettre à jour automatiquement tous les blocs d'agent utilisant ces outils avec les nouvelles définitions de paramètres.
## Utiliser les outils MCP dans les agents
Une fois les serveurs MCP configurés, leurs outils deviennent disponibles dans vos blocs d'agent :
<div className="flex justify-center">
<Image
src="/static/blocks/mcp-2.png"
alt="Utilisation d'un outil MCP dans un bloc Agent"
alt="Utilisation de l'outil MCP dans un bloc d'agent"
width={700}
height={450}
className="my-6"
@@ -61,7 +62,7 @@ Une fois les serveurs MCP configurés, leurs outils deviennent disponibles dans
## Bloc d'outil MCP autonome
Pour un contrôle plus précis, vous pouvez utiliser le bloc dédié d'outil MCP pour exécuter des outils MCP spécifiques :
Pour un contrôle plus précis, vous pouvez utiliser le bloc d'outil MCP dédié pour exécuter des outils MCP spécifiques :
<div className="flex justify-center">
<Image
@@ -76,52 +77,52 @@ Pour un contrôle plus précis, vous pouvez utiliser le bloc dédié d'outil MCP
Le bloc d'outil MCP vous permet de :
- Exécuter directement n'importe quel outil MCP configuré
- Transmettre des paramètres spécifiques à l'outil
- Utiliser la sortie de l'outil dans les étapes suivantes du flux de travail
- Enchaîner plusieurs outils MCP
- Utiliser la sortie de l'outil dans les étapes suivantes du workflow
- Enchaîner plusieurs outils MCP ensemble
### Quand utiliser l'outil MCP vs l'agent
### Quand utiliser l'outil MCP ou l'agent
**Utilisez l'agent avec les outils MCP quand :**
**Utilisez l'agent avec les outils MCP lorsque :**
- Vous voulez que l'IA décide quels outils utiliser
- Vous avez besoin d'un raisonnement complexe sur quand et comment utiliser les outils
- Vous souhaitez une interaction en langage naturel avec les outils
**Utilisez le bloc Outil MCP quand :**
- Vous avez besoin d'une exécution déterministe d'outils
- Vous souhaitez exécuter un outil spécifique avec des paramètres connus
- Vous construisez des flux de travail structurés avec des étapes prévisibles
**Utilisez le bloc outil MCP quand :**
- Vous avez besoin d'une exécution d'outil déterministe
- Vous voulez exécuter un outil spécifique avec des paramètres connus
- Vous construisez des workflows structurés avec des étapes prévisibles
## Exigences en matière d'autorisations
## Exigences de permission
Les fonctionnalités MCP nécessitent des autorisations spécifiques pour l'espace de travail :
La fonctionnalité MCP nécessite des permissions d'espace de travail spécifiques :
| Action | Autorisation requise |
| Action | Permission requise |
|--------|-------------------|
| Configurer les serveurs MCP dans les paramètres | **Admin** |
| Utiliser les outils MCP dans les agents | **Écriture** ou **Admin** |
| Voir les outils MCP disponibles | **Lecture**, **Écriture**, ou **Admin** |
| Exécuter des blocs d'Outil MCP | **Écriture** ou **Admin** |
| Voir les outils MCP disponibles | **Lecture**, **Écriture** ou **Admin** |
| Exécuter les blocs outil MCP | **Écriture** ou **Admin** |
## Cas d'utilisation courants
## Cas d'usage courants
### Intégration de bases de données
Connectez-vous aux bases de données pour interroger, insérer ou mettre à jour des données dans vos flux de travail.
### Intégration de base de données
Connectez-vous aux bases de données pour interroger, insérer ou mettre à jour des données dans vos workflows.
### Intégrations API
Accédez à des API externes et des services web qui n'ont pas d'intégrations Sim intégrées.
### Intégrations d'API
Accédez aux API externes et services web qui n'ont pas d'intégrations Sim intégrées.
### Accès au système de fichiers
Lisez, écrivez et manipulez des fichiers sur des systèmes de fichiers locaux ou distants.
### Logique métier personnalisée
Exécutez des scripts ou des outils personnalisés spécifiques aux besoins de votre organisation.
Exécutez des scripts ou outils personnalisés spécifiques aux besoins de votre organisation.
### Accès aux données en temps réel
Récupérez des données en direct à partir de systèmes externes pendant l'exécution du flux de travail.
Récupérez des données en direct depuis des systèmes externes pendant l'exécution du workflow.
## Considérations de sécurité
- Les serveurs MCP s'exécutent avec les autorisations de l'utilisateur qui les a configurés
- Les serveurs MCP s'exécutent avec les permissions de l'utilisateur qui les a configurés
- Vérifiez toujours les sources des serveurs MCP avant l'installation
- Utilisez des variables d'environnement pour les données de configuration sensibles
- Examinez les capacités du serveur MCP avant d'accorder l'accès aux agents
@@ -130,10 +131,10 @@ Récupérez des données en direct à partir de systèmes externes pendant l'ex
### Le serveur MCP n'apparaît pas
- Vérifiez que la configuration du serveur est correcte
- Vérifiez que vous disposez des autorisations requises
- Vérifiez que vous avez les permissions requises
- Assurez-vous que le serveur MCP est en cours d'exécution et accessible
### Échecs d'exécution d'outils
### Échecs d'exécution d'outil
- Vérifiez que les paramètres de l'outil sont correctement formatés
- Consultez les journaux du serveur MCP pour les messages d'erreur
- Assurez-vous que l'authentification requise est configurée

View File

@@ -0,0 +1,107 @@
---
title: ワークフローをMCPとしてデプロイ
description: 外部のAIアシスタントやアプリケーション向けに、ワークフローをMCPツールとして公開
---
import { Video } from '@/components/ui/video'
import { Callout } from 'fumadocs-ui/components/callout'
ワークフローをMCPツールとしてデプロイすることで、Claude Desktop、Cursor、その他のMCP互換クライアントなどの外部AIアシスタントからアクセス可能になります。これにより、ワークフローがどこからでも呼び出せる呼び出し可能なツールに変わります。
## MCPサーバーの作成と管理
MCPサーバーは、ワークフローツールをまとめてグループ化します。ワークスペース設定で作成と管理を行います。
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/mcp-server.mp4" width={700} height={450} />
</div>
1. **設定 → MCPサーバー**に移動
2. **サーバーを作成**をクリック
3. 名前と説明(任意)を入力
4. MCPクライアントで使用するためにサーバーURLをコピー
5. サーバーに追加されたすべてのツールを表示・管理
## ワークフローをツールとして追加
ワークフローがデプロイされたら、MCPツールとして公開できます。
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/mcp-deploy-tool.mp4" width={700} height={450} />
</div>
1. デプロイ済みのワークフローを開く
2. **デプロイ**をクリックし、**MCP**タブに移動
3. ツール名と説明を設定
4. 各パラメータの説明を追加(AIが入力を理解するのに役立ちます)
5. 追加先のMCPサーバーを選択
<Callout type="info">
ワークフローをMCPツールとして追加する前に、デプロイしておく必要があります。
</Callout>
## ツールの設定
### ツール名
小文字、数字、アンダースコアを使用します。名前は説明的で、MCPの命名規則に従う必要があります(例: `search_documents`、`send_email`)。
### 説明
ツールが何をするのかを明確に説明します。これにより、AIアシスタントがツールをいつ使用すべきかを理解できます。
### パラメータ
ワークフローの入力形式フィールドがツールパラメータになります。AIアシスタントが正しい値を提供できるよう、各パラメータに説明を追加してください。
## MCPクライアントの接続
設定から取得したサーバーURLを使用して外部アプリケーションを接続します:
### Claude Desktop
Claude Desktopの設定ファイル(`~/Library/Application Support/Claude/claude_desktop_config.json`)に追加してください:
```json
{
"mcpServers": {
"my-sim-workflows": {
"command": "npx",
"args": ["-y", "mcp-remote", "YOUR_SERVER_URL"]
}
}
}
```
### Cursor
同じmcp-remoteパターンを使用して、CursorのMCP設定にサーバーURLを追加してください。
<Callout type="warn">
mcp-remoteまたは他のHTTPベースのMCPトランスポートを使用する際は、認証アクセスのためにAPIキーヘッダー(`X-API-Key`)を含めてください。
</Callout>
## サーバー管理
**設定 → MCPサーバー**のサーバー詳細ビューから、以下の操作が可能です:
- **ツールを表示**: サーバーに追加されたすべてのワークフローを確認
- **URLをコピー**: MCPクライアント用のサーバーURLを取得
- **ワークフローを追加**: デプロイ済みワークフローをツールとして追加
- **ツールを削除**: サーバーからワークフローを削除
- **サーバーを削除**: サーバー全体とすべてのツールを削除
## 仕組み
MCPクライアントがツールを呼び出すと:
1. MCPサーバーURLでリクエストを受信
2. Simがリクエストを検証し、パラメータをワークフロー入力にマッピング
3. 提供された入力でデプロイ済みワークフローを実行
4. 結果をMCPクライアントに返却
ワークフローはAPI呼び出しと同じデプロイバージョンを使用して実行されるため、一貫した動作が保証されます。
## 必要な権限
| アクション | 必要な権限 |
|--------|-------------------|
| MCPサーバーを作成 | **管理者** |
| サーバーにワークフローを追加 | **書き込み**または**管理者** |
| MCPサーバーを表示 | **読み取り**、**書き込み**、または**管理者** |
| MCPサーバーを削除 | **管理者** |

View File

@@ -1,8 +1,10 @@
---
title: MCP(モデルコンテキストプロトコル)
title: MCPツールの使用
description: Model Context Protocolを使用して外部ツールとサービスを接続
---
import { Image } from '@/components/ui/image'
import { Video } from '@/components/ui/video'
import { Callout } from 'fumadocs-ui/components/callout'
モデルコンテキストプロトコル([MCP](https://modelcontextprotocol.com/)を使用すると、標準化されたプロトコルを使用して外部ツールやサービスを接続し、APIやサービスをワークフローに直接統合することができます。MCPを使用することで、エージェントやワークフローとシームレスに連携するカスタム統合機能を追加して、Simの機能を拡張できます。
@@ -20,14 +22,8 @@ MCPは、AIアシスタントが外部データソースやツールに安全に
MCPサーバーはエージェントが使用できるツールのコレクションを提供します。ワークスペース設定で構成してください
<div className="flex justify-center">
<Image
src="/static/blocks/mcp-1.png"
alt="設定でのMCPサーバーの構成"
width={700}
height={450}
className="my-6"
/>
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/settings-mcp-tools.mp4" width={700} height={450} />
</div>
1. ワークスペース設定に移動します
@@ -40,9 +36,13 @@ MCPサーバーはエージェントが使用できるツールのコレクシ
エージェントブロックのツールバーから直接MCPサーバーを構成することもできますクイックセットアップ
</Callout>
### ツールの更新
サーバーの**更新**をクリックすると、最新のツールスキーマを取得し、それらのツールを使用しているエージェントブロックを新しいパラメータ定義で自動的に更新します。
## エージェントでのMCPツールの使用
MCPサーバーが構成されると、そのツールエージェントブロック内で利用可能になります:
MCPサーバーが設定されると、そのツールエージェントブロック内で利用可能になります:
<div className="flex justify-center">
<Image
@@ -54,14 +54,14 @@ MCPサーバーが構成されると、そのツールはエージェントブ
/>
</div>
1. **エージェント**ブロックを開きます
1. **エージェント**ブロックを開
2. **ツール**セクションで、利用可能なMCPツールが表示されます
3. エージェントに使用させたいツールを選択します
4. これでエージェントは実行中にこれらのツールにアクセスできるようになります
3. エージェントに使用させたいツールを選択
4. エージェントは実行中にこれらのツールにアクセスできるようになります
## スタンドアロンMCPツールブロック
より細かい制御のために、特定のMCPツールを実行するための専用MCPツールブロックを使用できます:
より細かい制御が必要な場合は、専用のMCPツールブロックを使用して特定のMCPツールを実行できます:
<div className="flex justify-center">
<Image
@@ -73,18 +73,18 @@ MCPサーバーが構成されると、そのツールはエージェントブ
/>
</div>
MCPツールブロックでは以下のことが可能です:
- 構成済みのMCPツールを直接実行する
MCPツールブロックではのことができます:
- 設定済みのMCPツールを直接実行
- ツールに特定のパラメータを渡す
- ツールの出力を後続のワークフローステップで使用する
- ツールの出力を後続のワークフローステップで使用
- 複数のMCPツールを連鎖させる
### MCPツールとエージェントの使い分け
**エージェントとMCPツールを使用する場合:**
- AIにどのツールを使用するか決定させたい場合
- ツールをいつどのように使用するかについて複雑な推論が必要な場合
- ツールと自然言語でのやり取りが必要な場合
**MCPツールを使用したエージェントを使用する場合:**
- AIにどのツールを使用するか決定させたい
- ツールをいつどのように使用するかについて複雑な推論が必要
- ツールと自然言語による対話が必要
**MCPツールブロックを使用する場合**
- 決定論的なツール実行が必要な場合
@@ -97,34 +97,34 @@ MCP機能には特定のワークスペース権限が必要です
| アクション | 必要な権限 |
|--------|-------------------|
| 設定でMCPサーバーを構成する | **管理者** |
| エージェントでMCPツールを使用する | **書き込み** または **管理者** |
| 利用可能なMCPツールを表示する | **読み取り**、**書き込み**、または **管理者** |
| MCPツールブロックを実行する | **書き込み** または **管理者** |
| 設定でMCPサーバーを構成 | **管理者** |
| エージェントでMCPツールを使用 | **書き込み**または**管理者** |
| 利用可能なMCPツールを表示 | **読み取り**、**書き込み**、または**管理者** |
| MCPツールブロックを実行 | **書き込み**または**管理者** |
## 一般的なユースケース
## 一般的な使用例
### データベース統合
ワークフロー内でデータのクエリ、挿入、更新を行うためにデータベースに接続します。
データベースに接続して、ワークフロー内でデータのクエリ、挿入、更新を行ます。
### API統合
組み込みのSim統合がない外部APIやWebサービスにアクセスします。
Simに組み込まれていない外部APIやWebサービスにアクセスします。
### ファイルシステムアクセス
ローカルまたはリモートファイルシステム上のファイルの読み取り、書き込み、操作を行います。
ローカルまたはリモートファイルシステム上のファイルの読み取り、書き込み、操作を行います。
### カスタムビジネスロジック
組織のニーズに特化したカスタムスクリプトやツールを実行します。
組織固有のニーズに合わせたカスタムスクリプトやツールを実行します。
### リアルタイムデータアクセス
ワークフロー実行中に外部システムからライブデータを取得します。
## セキュリティに関する考慮事項
- MCPサーバーは構成したユーザーの権限で実行されます
- MCPサーバーは、それを構成したユーザーの権限で実行されます
- インストール前に必ずMCPサーバーのソースを確認してください
- 機密性の高い構成データには環境変数を使用してください
- エージェントにアクセス権を付与する前にMCPサーバーの機能を確認してください
- エージェントにアクセスを許可する前にMCPサーバーの機能を確認してください
## トラブルシューティング
@@ -139,6 +139,6 @@ MCP機能には特定のワークスペース権限が必要です
- 必要な認証が構成されていることを確認してください
### 権限エラー
- ワークスペースの権限レベルを確認する
- MCPサーバーが追加認証を必要としているか確認する
- サーバーがワークスペースに適切に構成されているか確認する
- ワークスペースの権限レベルを確認してください
- MCPサーバーが追加認証を必要としているか確認してください
- サーバーがワークスペースに対して適切に設定されているか確認してください

View File

@@ -0,0 +1,107 @@
---
title: 将工作流部署为 MCP
description: 将您的工作流公开为 MCP 工具,供外部 AI 助手和应用程序使用
---
import { Video } from '@/components/ui/video'
import { Callout } from 'fumadocs-ui/components/callout'
将您的工作流部署为 MCP 工具,使其可供外部 AI 助手(如 Claude Desktop、Cursor 以及其他兼容 MCP 的客户端)访问。这会让您的工作流变成可随时调用的工具。
## 创建和管理 MCP 服务器
MCP 服务器用于将您的工作流工具进行分组。您可以在工作区设置中创建和管理这些服务器:
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/mcp-server.mp4" width={700} height={450} />
</div>
1. 进入 **设置 → MCP 服务器**
2. 点击 **创建服务器**
3. 输入名称和可选描述
4. 复制服务器 URL 以在您的 MCP 客户端中使用
5. 查看并管理已添加到服务器的所有工具
## 添加工作流为工具
当您的工作流部署完成后,可以将其公开为 MCP 工具:
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/mcp-deploy-tool.mp4" width={700} height={450} />
</div>
1. 打开已部署的工作流
2. 点击 **部署** 并进入 **MCP** 标签页
3. 配置工具名称和描述
4. 为每个参数添加描述(帮助 AI 理解输入)
5. 选择要添加到的 MCP 服务器
<Callout type="info">
工作流必须先部署,才能添加为 MCP 工具。
</Callout>
## 工具配置
### 工具名称
请使用小写字母、数字和下划线。名称应具有描述性,并遵循 MCP 命名规范(如 `search_documents`、`send_email`)。
### 描述
请清晰描述该工具的功能。这有助于 AI 助手理解何时使用该工具。
### 参数
您的工作流输入格式字段会变成工具参数。为每个参数添加描述,有助于 AI 助手提供正确的值。
## 连接 MCP 客户端
使用设置中的服务器 URL 连接外部应用程序:
### Claude Desktop
将以下内容添加到您的 Claude Desktop 配置中(`~/Library/Application Support/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"my-sim-workflows": {
"command": "npx",
"args": ["-y", "mcp-remote", "YOUR_SERVER_URL"]
}
}
}
```
### Cursor
在 Cursor 的 MCP 设置中,使用相同的 mcp-remote 格式添加服务器 URL。
<Callout type="warn">
使用 mcp-remote 或其他基于 HTTP 的 MCP 传输方式时,请包含 API key header`X-API-Key`)以进行身份验证访问。
</Callout>
## 服务器管理
在 **设置 → MCP 服务器** 的服务器详情视图中,您可以:
- **查看工具**:查看添加到服务器的所有工作流
- **复制 URL**:获取 MCP 客户端的服务器 URL
- **添加工作流**:将更多已部署的工作流添加为工具
- **移除工具**:从服务器中移除工作流
- **删除服务器**:移除整个服务器及其所有工具
## 工作原理
当 MCP 客户端调用您的工具时:
1. 请求会发送到您的 MCP 服务器 URL
2. Sim 验证请求并将参数映射到工作流输入
3. 已部署的工作流会使用提供的输入执行
4. 结果返回给 MCP 客户端
工作流执行时使用与 API 调用相同的部署版本,确保行为一致。
## 权限要求
| 操作 | 所需权限 |
|--------|-------------------|
| 创建 MCP 服务器 | **Admin** |
| 向服务器添加工作流 | **Write** 或 **Admin** |
| 查看 MCP 服务器 | **Read**、**Write** 或 **Admin** |
| 删除 MCP 服务器 | **Admin** |

View File

@@ -1,8 +1,10 @@
---
title: MCP模型上下文协议
title: 使用 MCP 工具
description: 通过 Model Context Protocol 连接外部工具和服务
---
import { Image } from '@/components/ui/image'
import { Video } from '@/components/ui/video'
import { Callout } from 'fumadocs-ui/components/callout'
模型上下文协议([MCP](https://modelcontextprotocol.com/))允许您使用标准化协议连接外部工具和服务,从而将 API 和服务直接集成到您的工作流程中。通过 MCP您可以通过添加自定义集成来扩展 Sim 的功能,使其与您的代理和工作流程无缝协作。
@@ -20,14 +22,8 @@ MCP 是一项开放标准,使 AI 助手能够安全地连接到外部数据源
MCP 服务器提供工具集合,供您的代理使用。您可以在工作区设置中进行配置:
<div className="flex justify-center">
<Image
src="/static/blocks/mcp-1.png"
alt="在设置中配置 MCP 服务器"
width={700}
height={450}
className="my-6"
/>
<div className="mx-auto w-full overflow-hidden rounded-lg">
<Video src="mcp/settings-mcp-tools.mp4" width={700} height={450} />
</div>
1. 进入您的工作区设置
@@ -40,56 +36,60 @@ MCP 服务器提供工具集合,供您的代理使用。您可以在工作区
您还可以直接从代理模块的工具栏中配置 MCP 服务器,以便快速设置。
</Callout>
## 在代理中使用 MCP 工具
### 刷新工具
一旦配置了 MCP 服务器,其工具将在您的代理模块中可用:
点击服务器上的 **刷新**,即可获取最新的工具 schema并自动用新的参数定义更新所有使用这些工具的 agent 模块。
## 在 Agent 中使用 MCP 工具
配置好 MCP 服务器后,其工具会在你的 agent 模块中可用:
<div className="flex justify-center">
<Image
src="/static/blocks/mcp-2.png"
alt="在代理模块中使用 MCP 工具"
alt="在 Agent 模块中使用 MCP 工具"
width={700}
height={450}
className="my-6"
/>
</div>
1. 打开一个 **代理** 模块
2. 在 **工具** 部分,您将看到可用的 MCP 工具
3. 选择希望代理使用的工具
4. 代理现在可以在执行过程中访问这些工具
1. 打开一个 **Agent** 模块
2. 在 **工具** 部分,你会看到可用的 MCP 工具
3. 选择希望 agent 使用的工具
4. agent 在执行时即可访问这些工具
## 独立 MCP 工具模块
## 独立 MCP 工具模块
为了更精细的控制,可以使用专用的 MCP 工具模块来执行特定的 MCP 工具:
如需更细致的控制,可以使用专用的 MCP 工具模块来执行特定的 MCP 工具:
<div className="flex justify-center">
<Image
src="/static/blocks/mcp-3.png"
alt="独立 MCP 工具模块"
alt="独立 MCP 工具模块"
width={700}
height={450}
className="my-6"
/>
</div>
MCP 工具模块允许您
- 直接执行任已配置的 MCP 工具
MCP 工具模块可以让你
- 直接执行任已配置的 MCP 工具
- 向工具传递特定参数
- 在后续工作流步骤中使用工具输出
- 多个 MCP 工具串联在一起
- 在后续工作流步骤中使用工具输出
- 串联多个 MCP 工具
### 何时使用 MCP 工具与代理
### 何时使用 MCP 工具模块与 Agent
**在以下情况下使用带有 MCP 工具的代理**
- 希望 AI 决定使用哪些工具
- 需要复杂推理来决定何时及如何使用工具
- 希望与工具进行自然语言交互
**当你需要以下场景时,使用 Agent 搭配 MCP 工具:**
- 希望 AI 决定使用哪些工具
- 需要复杂推理来判断何时及如何使用工具
- 希望通过自然语言与工具交互
**在以下情况下使用 MCP 工具块:**
- 需要确定性的工具执行
- 您希望使用已知参数执行特定工具
- 正在构建具有可预测步骤的结构化工作流
- 需要确定性的工具执行
- 你想用已知参数执行特定工具
- 正在构建具有可预测步骤的结构化工作流
## 权限要求
@@ -97,48 +97,48 @@ MCP 功能需要特定的工作区权限:
| 操作 | 所需权限 |
|--------|-------------------|
| 在设置中配置 MCP 服务器 | **管理员** |
| 在代理中使用 MCP 工具 | **写入** 或 **管理员** |
| 查看可用的 MCP 工具 | **读取**、**写入** 或 **管理员** |
| 执行 MCP 工具块 | **写入** 或 **管理员** |
| 在设置中配置 MCP 服务器 | **Admin** |
| 在代理中使用 MCP 工具 | **Write** 或 **Admin** |
| 查看可用的 MCP 工具 | **Read**、**Write** 或 **Admin** |
| 执行 MCP 工具块 | **Write** 或 **Admin** |
## 常见使用场景
## 常见用例
### 数据库集成
连接数据库以在工作流中查询、插入或更新数据。
在你的工作流中连接数据库以查询、插入或更新数据。
### API 集成
访问没有内置 Sim 集成的外部 API 和 Web 服务。
### 文件系统访问
读取、写入和操作本地或远程文件系统上文件。
本地或远程文件系统上读取、写入和操作文件。
### 自定义业务逻辑
执行特定于您组织需求的自定义脚本或工具。
执行针对你组织需求的自定义脚本或工具。
### 实时数据访问
在工作流执行期间从外部系统获取实时数据。
## 安全注意事项
- MCP 服务器以配置它的用户权限运行
- 安装前始终验证 MCP 服务器来源
- 对敏感配置数据,请使用环境变量
- 在授予代理访问权限前,审查 MCP 服务器功能
- MCP 服务器以配置它的用户权限运行
- 安装前务必验证 MCP 服务器来源
- 对敏感配置信息使用环境变量
- 在授予代理访问权限前,审查 MCP 服务器功能
## 故障排
## 故障排
### MCP 服务器未显示
- 验证服务器配置是否正确
- 检查是否有所需权限
- 检查是否有所需权限
- 确保 MCP 服务器正在运行且可访问
### 工具执行失败
- 验证工具参数格式是否正确
- 检查 MCP 服务器日志中的错误
- 检查 MCP 服务器日志中的错误
- 确保已配置所需的身份验证
### 权限错误
- 确认的工作区权限级别
- 检查 MCP 服务器是否需要额外的身份验
- 验证服务器是否已为的工作区正确配置
- 确认的工作区权限级别
- 检查 MCP 服务器是否需要额外
- 验证服务器是否已为的工作区正确配置

View File

@@ -4333,43 +4333,46 @@ checksums:
content/42: 824d6c95976aa25ee803b3591fb6f551
content/43: 864966620e19c8746d8180efdbdd9ae2
d73ad89134a95ad7e09fa05b910065aa:
meta/title: f313501a9bef9974d92f1d62b42fdb93
content/0: 0d95e6a3f94bfb96c6dc0d0784c08ea4
meta/title: 9c04618798e86e654d5079fe8de64db1
meta/description: 4da9477901d9df3c9450ba039d75dd37
content/0: 0d1f255ba4a6e466a883628166c021ea
content/1: 1f65550d1e29bd4153aff03620240d9a
content/2: d5b2535caa6733200d5bfe237593ce3c
content/3: b712a1e4dd21fd6b0e930199354adcc3
content/4: ca67b9905e9e11c157e61b0ab389538f
content/5: 6eee8c607e72b6c444d7b3ef07244f20
content/6: 747991e0e80e306dce1061ef7802db2a
content/7: 704a7a653c2dc25f6695a6744ca751d3
content/7: 430153eacb29c66026cf71944df7be20
content/8: 5950966e19939b7a3a320d56ee4a674c
content/9: 159cf7a6d62e64b0c5db27e73b8c1ff5
content/10: 5bcbd52289426d30d910b18bd3906752
content/11: eea4f7ee41a1df57efbc383261657577
content/12: 228fb76870c6a4f77ede7ee70b9e88ae
content/13: 220fe4f7ae4350eb17a45ca7824f1588
content/14: 8c8337d290379b6e1ed445e9be94a9d1
content/15: 5d31ac96fab4fe61b0c50b04d3c5334d
content/16: b6daf5b4a671686abe262dc86e1a8455
content/17: 80c0384b94d64548d753f8029c2bba7f
content/18: 606502329e2f62e12f33e39a640ceb10
content/19: b57cfd7d01cf1ce7566d9adfd7629e93
content/20: 3beb1b867645797faddd37a84bcb6277
content/21: 47eb215a0fc230dc651b7bc05ab25ed0
content/22: 175a21923c1df473224c54959ecbdb57
content/23: 8305e779bb6f866f2e2998c374bc8af0
content/24: a6b82eda019a997e4cb55f4461d0ae16
content/25: ce8fdb26d2fcbd3f47f1032077622719
content/26: 97855f8f10fd385774bc2dde42f96540
content/27: 06cd80699da60d9bcce09ee32c0136fc
content/28: ebaa0614d49146e17b04fb3be190209f
content/29: 14d09c6d97ba08f6e7ea6be3ed854cad
content/30: 90fb56f9810d8f8803f19be7907bee90
content/31: fbf5d3ade971a3e039c715962db85ea9
content/32: 623d40dc1cfdd82c4d805d6b02471c75
content/33: 03c45c32e80d7d8875d339a0640f2f63
content/34: 3d01b1e7080fee49ffb40b179873b676
content/35: 81dcc5343377a51a32fe8d23fc172808
content/10: a723187777f9a848d4daa563e9dcbe17
content/11: b1c5f14e5290bcbbf5d590361ee7c053
content/12: 5bcbd52289426d30d910b18bd3906752
content/13: eea4f7ee41a1df57efbc383261657577
content/14: 228fb76870c6a4f77ede7ee70b9e88ae
content/15: 220fe4f7ae4350eb17a45ca7824f1588
content/16: 8c8337d290379b6e1ed445e9be94a9d1
content/17: 5d31ac96fab4fe61b0c50b04d3c5334d
content/18: b6daf5b4a671686abe262dc86e1a8455
content/19: 80c0384b94d64548d753f8029c2bba7f
content/20: 606502329e2f62e12f33e39a640ceb10
content/21: b57cfd7d01cf1ce7566d9adfd7629e93
content/22: 3beb1b867645797faddd37a84bcb6277
content/23: 47eb215a0fc230dc651b7bc05ab25ed0
content/24: 175a21923c1df473224c54959ecbdb57
content/25: 8305e779bb6f866f2e2998c374bc8af0
content/26: a6b82eda019a997e4cb55f4461d0ae16
content/27: ce8fdb26d2fcbd3f47f1032077622719
content/28: 97855f8f10fd385774bc2dde42f96540
content/29: 06cd80699da60d9bcce09ee32c0136fc
content/30: ebaa0614d49146e17b04fb3be190209f
content/31: 14d09c6d97ba08f6e7ea6be3ed854cad
content/32: 90fb56f9810d8f8803f19be7907bee90
content/33: fbf5d3ade971a3e039c715962db85ea9
content/34: 623d40dc1cfdd82c4d805d6b02471c75
content/35: 03c45c32e80d7d8875d339a0640f2f63
content/36: 3d01b1e7080fee49ffb40b179873b676
content/37: 81dcc5343377a51a32fe8d23fc172808
936c6450f0e3755fffa26ec3d3bd1b54:
meta/title: 2e89ff9f9632dacf671ce83787447240
content/0: 7e581dbf3e581d503ac94f7fb7938b1f
@@ -50130,3 +50133,36 @@ checksums:
content/124: 7be2eecb48d34398e118f223e7947adc
content/125: b3f310d5ef115bea5a8b75bf25d7ea9a
content/126: b6825d890bccce15d748ceb727d30104
f3ceca041234b3c5122b03bc11e4d1c1:
meta/title: 960685e215a11e2b38285dff5b0dde47
meta/description: 671e4d9e7ed6dd8b7774dcd4cfbecade
content/0: 833213d7266febc5d9ac218725cfb057
content/1: 10dedb2b36131c07ec48f97ece922c8c
content/2: b082096b0c871b2a40418e479af6f158
content/3: 9c94aa34f44540b0632931a8244a6488
content/4: 14f33e16b5a98e4dbdda2a27aa0d7afb
content/5: d7b36732970b7649dd1aa1f1d0a34e74
content/6: f554f833467a6dae5391372fc41dad53
content/7: 9cdb9189ecfcc4a6f567d3fd5fe342f0
content/8: 9a107692cb52c284c1cb022b516d700b
content/9: 07a013a9b263ab0ae4458db97065bdcd
content/10: 9310a48f3e485c5709563f1b825eb32d
content/11: 8a2c3d1a1a30e3614ada44b88478cc0c
content/12: defcb9a4ec64b567f45c3669c214763f
content/13: 4f3202eff0734a7398445d8c54f9e3ad
content/14: afcee4eacb27fb678e159c512d114c2d
content/15: 4ecff63a3571ef6f519a2448931451c2
content/16: 880b1c60228a0b56c5eb62dac87792df
content/17: d3f79ae3be3fe3ca4df5bd59be6b404c
content/18: 028eb92d4776faeb029995cee976bfc4
content/19: a618fcff50c4856113428639359a922b
content/20: 5fd3a6d2dcd8aa18dbf0b784acaa271c
content/21: d118656dd565c4c22f3c0c3a7c7f3bee
content/22: f49b9be78f1e7a569e290acc1365d417
content/23: 0a70ebe6eb4c543c3810977ed46b69b0
content/24: ad8638a3473c909dbcb1e1d9f4f26381
content/25: 95343a9f81cd050d3713988c677c750f
content/26: d4f846a591ac7fdedaba281b44d50ae3
content/27: 764eb0e5d025b68f772d45adb7608349
content/28: 47eb215a0fc230dc651b7bc05ab25ed0
content/29: bf5c6bf1e75c5c5e3a0a5dd1314cb41e