Conectar Procore con Microsoft Copilot (MCP)

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Procore, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

Procore + Microsoft Copilot

Lee proyectos de construcción de Procore: empresas, proyectos y directorio, RFI y submittals, partes diarios y de mano de obra, documentos y archivos del proyecto, vistas y partidas de presupuesto, subcontratos y órdenes de compra. OAuth 2.0, solo lectura.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

PROCORE_CLIENT_ID, PROCORE_CLIENT_SECRET

Paso 1 — Obtener credenciales

El conector lee Procore mediante OAuth 2.0 y nunca escribe. Cada llamada se ejecuta como el usuario de Procore que lo autorizó y ve lo que ve ese usuario.

1. Inicia sesión en https://developers.procore.com, haz clic en Create New App y añade una credencial OAuth de tipo Web server application. Pon como URI de redirección <your AnythingMCP URL>/api/mcp-oauth/callback (en AnythingMCP Cloud: https://cloud.anythingmcp.com/api/mcp-oauth/callback).
2. Copia el client ID y el client secret de producción en PROCORE_CLIENT_ID y PROCORE_CLIENT_SECRET.
3. Un administrador de la empresa en Procore instala la app en la empresa (Company Admin > App Management > Install Custom App, con la version key de la app). Sin eso, los datos de la empresa no son accesibles.
4. En la página del conector haz clic en Authorize with Provider e inicia sesión en Procore. Los tokens se renuevan solos.
5. Empieza con procore_list_companies para el id de la empresa y luego procore_list_projects. Toda herramienta de ámbito empresa recibe company_id; sin él, Procore responde 400.

Conviene saber:

• Un 403 significa que la plantilla de permisos del usuario no da acceso a esa herramienta (RFIs, Budget, Documents) en el proyecto. Las herramientas de presupuesto y contratos necesitan las herramientas Financials activadas en el proyecto.
• Los listados devuelven 100 elementos por página; pasa page y per_page.
• El límite es de 3.600 peticiones por hora por app y usuario; un 429 indica cuándo reintentar.
• Para probar contra un sandbox de desarrollador, cambia en los ajustes del conector la URL base y las URL de OAuth a https://sandbox.procore.com y https://login-sandbox.procore.com.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Procore.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse