copilot-studio-code

Un servidor MCP local que proporciona a un agente de Microsoft Copilot Studio herramientas al estilo de Claude-Code para interactuar con tu sistema de archivos local y tu shell: lee, edita, busca y ejecuta comandos desde el lienzo de pruebas de Copilot Studio. Se incluye una solución de Copilot Studio importable para que puedas configurar un agente funcional en minutos.

Herramientas expuestas

Modos de seguridad (seleccionados al inicio)

Cómo se elige el modo, en orden de precedencia:

1. Variable de entorno SAFETY (strict / moderate / open)

2. Flag de CLI --safety <mode>

3. Prompt interactivo al inicio (tiempo de espera de 10s → moderate)

Todas las llamadas a write_file, edit_file y run_shell se añaden a <root>/.copilotstudio-mcp/audit.log.

Ejecución

npm install
npm start

El servidor imprime algo como:

copilot-studio-code MCP server
  workspace root : E:\Dev\projects\my-project
  safety mode    : moderate
  listening on   : http://localhost:8787/mcp
  health check   : http://localhost:8787/healthz

Sobrescribe el espacio de trabajo sobre el que opera:

$env:WORKSPACE_ROOT = "E:\Dev\some-other-project"; npm start

Conexión con Copilot Studio

Copilot Studio está alojado en la nube, por lo que no puede acceder a localhost. Utiliza Microsoft Dev Tunnels para exponer el servidor a través de HTTPS.

1. Instala e inicia sesión en dev tunnels

winget install Microsoft.devtunnel
devtunnel user login

2. Crea un túnel persistente para el puerto 8787

devtunnel create copilotstudio-mcp --allow-anonymous
devtunnel port create copilotstudio-mcp -p 8787 --protocol http
devtunnel host copilotstudio-mcp

devtunnel host imprime una URL pública como https://<id>-8787.usw2.devtunnels.ms. Déjalo ejecutándose.

Elimina --allow-anonymous y el túnel requerirá una cuenta de MS en el lado de Copilot Studio. Recomendado una vez que lo tengas funcionando.

3. Conecta el servidor MCP a un agente de Copilot Studio

Dos formas: importar la solución preconstruida (más rápido) o configurar un agente manualmente.

Ruta A — Importar la solución preconstruida

La carpeta solution/ contiene una solución de Copilot Studio no gestionada que incluye un agente preconfigurado (orquestación generativa activada, moderación de contenido baja), un conector personalizado para el servidor MCP y un tema WorkspaceMCP que muestra las herramientas al planificador.

1. Abre https://make.powerapps.com → tu entorno → Soluciones → Importar solución.

2. Sube solution/CopilotStudioCode_1_0_0_0.zip. Acepta los valores predeterminados durante el asistente.

3. Una vez importado, abre el conector personalizado Workspace MCP → Editar → en la pestaña General, reemplaza el host de marcador de posición YOUR-TUNNEL-ID-PORT.YOUR-REGION.devtunnels.ms con tu host de túnel de desarrollo real (ej. abc123-8787.usw2.devtunnels.ms). Guarda → Actualizar conector.

4. Abre el agente importado y salta al paso 4 (lienzo de pruebas).

La solución no incluye el servidor MCP en sí; este se ejecuta localmente desde este repositorio. El conector solo apunta a él.

Ruta B — Configurar un agente manualmente

1. Abre Copilot Studio → tu agente → Herramientas → + Añadir una herramienta → Protocolo de contexto de modelo (MCP).

2. URL del servidor: https://<your-tunnel-id>-8787.usw2.devtunnels.ms/mcp

3. Autenticación: Ninguna (para el túnel anónimo) o Microsoft Entra (para uno autenticado).

4. Guarda. Copilot Studio obtiene la lista de herramientas desde /mcp y muestra las siete herramientas. Asegúrate de que cada una esté habilitada en el agente.

5. Configuración → IA generativa → Orquestación: Generativa; moderación de contenido: Baja. Sin la orquestación generativa, el planificador no enviará las herramientas MCP.

4. Pruébalo desde el lienzo de pruebas

Abre el lienzo de pruebas y prueba prompts como:

• "List the files in the workspace root."

• "Read package.json and tell me what scripts are defined."

• "Add a new script called lint that runs tsc --noEmit."

• "Run git status and summarize the result."

El agente elige las herramientas por nombre a partir de las descripciones en src/tools.ts: ajusta esas descripciones si el agente elige la herramienta incorrecta.

Diseño del proyecto

src/                                  the MCP server (TypeScript)
  index.ts                            entry: safety prompt + boot
  server.ts                           express + Streamable HTTP MCP transport
  tools.ts                            the seven tool registrations
  safety.ts                           mode definitions
  paths.ts                            workspace-root path jail
  audit.ts                            JSONL audit log
solution/                             importable Copilot Studio solution
  CopilotStudioCode_1_0_0_0.zip       agent + connector + topics (unmanaged)