Endpoint y autorización
POST https://teamwide.app/mcpEl endpoint requiere un token OAuth de tipo Bearer. La información para descubrir el servidor de autorización está disponible en /.well-known/oauth-authorization-server. Las solicitudes sin un token Bearer válido devuelven el estado 401.
Solicite el ámbito read para consultar o read write para editar. Cada herramienta comprueba el ámbito requerido y los permisos actuales del espacio de trabajo y de la pizarra. Si un token existente no tiene el ámbito requerido, es necesario volver a establecer la conexión.
Herramientas disponibles
El servidor ofrece actualmente la identificación y el listado de espacios de trabajo, operaciones con pizarras, colecciones, miembros, contenedores y conectores, instantáneas de pizarras y exportación a PNG/PDF. Las herramientas que modifican datos siguen las mismas reglas de cuenta, suscripción y permisos que la interfaz web.
Trabajo conjunto en una pizarra
Varios agentes pueden trabajar en una misma pizarra al mismo tiempo. Los cambios se muestran en directo a los participantes que han iniciado sesión. Las comprobaciones de versión notifican los conflictos en lugar de sobrescribir los cambios sin avisar.
Flujo de trabajo del lienzo
Comience con whoami y account_list y después pase el account_id seleccionado a las operaciones de la pizarra. Utilice explore_board para obtener un resumen y get_containers para consultar los detalles seleccionados. Cargue get_canvas_guide una vez para consultar las reglas de coordenadas, los límites y los ejemplos completos.
Cree objetos y flechas relacionados con apply_canvas_changes. Si una operación falla, se revierten todos los cambios del lote completo. Tras una respuesta incierta, reutilice el mismo identificador de solicitud y los mismos datos para evitar objetos duplicados. Para editar, pase la versión más reciente del objeto; los cambios simultáneos provocan un conflicto en lugar de sobrescribirse.
Utilice patch_container_content para reemplazos de texto exactos, create_image_upload y insert_uploaded_image para imágenes locales y get_board_image para inspeccionar el diseño resultante. Los esquemas de herramientas describen los valores aceptados, los formatos de salida y los límites de paginación.
Si una imagen ya tiene una URL pública, pase esa URL directa como content a create_container con content_type: image. El servidor descarga y adjunta el archivo. Solo la URL se transmite a través de MCP. Utilice update_container con una nueva URL para sustituir una imagen; los archivos locales se suben directamente a la URL firmada.
Configuración del cliente
Configure https://teamwide.app/mcp como endpoint MCP remoto en un cliente compatible con el descubrimiento de servidores de autorización OAuth y con PKCE. Autorice el acceso en Teamwide. Utilice account_list para seleccionar un espacio de trabajo y pase su account_id a las operaciones posteriores de la pizarra.