Cómo conectar Microsoft SharePoint a Gemini vía MCP

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

Microsoft SharePoint + Gemini

Deja que tu IA trabaje en SharePoint: busca sitios, explora y busca en bibliotecas de documentos, consulta los detalles de los archivos y quién tiene acceso, lee, crea y actualiza elementos de listas, crea listas, carpetas y archivos de texto, lee páginas de sitios y búscalo todo con Microsoft Search. Microsoft 365 a través de Microsoft Graph, con el inicio de sesión de tu cuenta profesional.

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:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Paso 1 — Obtener credenciales

1. Abre el centro de administración de Microsoft Entra (entra.microsoft.com) o el portal de Azure y ve a Applications → App registrations → New registration.

2. Ponle un nombre a la app (por ejemplo "AnythingMCP Microsoft 365") y elige los Supported account types. La elección decide qué va en MICROSOFT_TENANT_ID:

   • Accounts in this organizational directory only (un solo inquilino): solo pueden iniciar sesión los usuarios de tu organización. Usa el Directory (tenant) ID de la página Overview de la app (un GUID) o tu dominio, por ejemplo contoso.onmicrosoft.com.
   • Accounts in any organizational directory (multiinquilino): usa organizations.
   • Accounts in any organizational directory and personal Microsoft accounts: usa common. Las cuentas personales de Microsoft no tienen SharePoint, así que pueden iniciar sesión pero no obtienen datos.

   Si el valor no coincide con el tipo de cuenta, Microsoft rechaza el inicio de sesión (AADSTS50194 o AADSTS50020).

3. En Redirect URI elige la plataforma Web e introduce https://cloud.anythingmcp.com/api/mcp-oauth/callback. Si alojas AnythingMCP tú mismo, introduce en su lugar https://tu-host-anythingmcp/api/mcp-oauth/callback. El URI debe coincidir carácter por carácter; si no, Microsoft responde AADSTS50011.

4. Abre API permissions → Add a permission → Microsoft Graph → Delegated permissions y añade offline_access, User.Read, Sites.ReadWrite.All y Files.ReadWrite.All. offline_access hace que Microsoft emita un refresh token; sin él, el conector deja de funcionar una hora después de autorizarlo.

5. Abre Certificates & secrets → New client secret. Copia el Value del secreto, no el Secret ID; solo se muestra una vez. Anota la fecha de caducidad: cuando el secreto caduca, el conector deja de funcionar hasta que crees uno nuevo y lo pegues.

6. Pega el Application (client) ID de la página Overview en MICROSOFT_CLIENT_ID, el valor del secreto en MICROSOFT_CLIENT_SECRET y el valor del inquilino del paso 2 en MICROSOFT_TENANT_ID, e instala el conector.

7. En la página del conector, haz clic en Authorize with Provider e inicia sesión con la cuenta profesional cuyos sitios de SharePoint debe usar la IA. El refresh token se guarda cifrado y los access tokens (válidos durante una hora aproximadamente) se renuevan automáticamente.

8. Empieza con sharepoint_get_root_site: muestra el sitio raíz de tu organización y confirma que se puede acceder a SharePoint.

Qué significa ".All": en estos permisos delegados, All significa "todos los sitios que puede abrir el usuario que ha iniciado sesión". La IA nunca obtiene más acceso a SharePoint que el que tiene ese usuario.

Una sola app de Entra para todos los conectores de Microsoft: el registro de app que creaste para el conector de Outlook, OneDrive o Excel también sirve aquí. Ábrelo, añade los permisos del paso 4 en API permissions, conserva el mismo URI de redirección y reutiliza el mismo ID de cliente, el mismo secreto y el mismo inquilino. Cada conector pide solo sus propios permisos cuando lo autorizas:

• Outlook: Mail.ReadWrite, Mail.Send, Calendars.ReadWrite
• OneDrive: Files.ReadWrite
• Excel: Files.ReadWrite (más Files.ReadWrite.All para libros en SharePoint o compartidos contigo)
• SharePoint: Sites.ReadWrite.All y Files.ReadWrite.All

Todos necesitan además offline_access y User.Read.

Consentimiento del administrador: estos permisos delegados normalmente no necesitan un administrador, pero muchas organizaciones desactivan el consentimiento de los usuarios. Si el inicio de sesión muestra "Need admin approval" (AADSTS65001 o AADSTS90094), un administrador del inquilino abre una vez el registro de la app y hace clic en API permissions → Grant admin consent para la organización. Después, cualquier usuario puede autorizar. Cada conector sigue trabajando solo con lo que puede ver la cuenta que inició sesión.

Solo lectura: añade Sites.Read.All y Files.Read.All al registro de la app, sustituye los scopes en los ajustes OAuth del conector por offline_access User.Read Sites.Read.All Files.Read.All, vuelve a autorizar y desactiva sharepoint_create_list_item, sharepoint_update_list_item, sharepoint_create_list, sharepoint_create_folder, sharepoint_upload_text_file, sharepoint_rename_drive_item y sharepoint_move_drive_item.

Desactivadas al instalar: sharepoint_delete_list_item, sharepoint_delete_drive_item, sharepoint_create_sharing_link y sharepoint_invite. Los enlaces para compartir y las invitaciones están desactivados a propósito: dan a otras personas acceso a los archivos de tu organización, y un documento que lee la IA podría contener un texto que le pida compartir algo. Activa una herramienta solo si la IA de verdad la necesita. Los elementos eliminados van a la papelera de reciclaje del sitio.

Cómo orientarse: la IA encuentra un sitio por palabra clave o a partir de su dirección (por ejemplo https://contoso.sharepoint.com/sites/Marketing) y luego abre sus bibliotecas de documentos y sus listas. sharepoint_search usa Microsoft Search en todos los sitios, archivos y elementos de listas que puedes ver. Se pueden leer las páginas de sitio modernas; las páginas clásicas, las noticias y la edición de páginas no están cubiertas.

Listas: los valores de una lista se guardan con el nombre interno de cada columna, que puede ser distinto del nombre que ves (una columna que aparece como "Fecha de vencimiento" puede llamarse DueDate). La IA lee primero las columnas con sharepoint_list_columns. En listas con más de 5.000 elementos, SharePoint solo filtra y ordena por columnas indexadas.

Archivos y contenido: el conector no descarga el contenido de los archivos: la IA te da el enlace del archivo. Crea archivos de texto de hasta unos 4 MB y, de forma predeterminada, nunca sobrescribe un archivo existente. Para las celdas de los libros de Excel de una biblioteca, usa el conector de Microsoft Excel.

Errores frecuentes: 401 InvalidAuthenticationToken significa que la autorización se revocó o que el client secret caducó; pega un secreto nuevo si hace falta y vuelve a hacer clic en Authorize with Provider. 403 accessDenied significa que falta un permiso del paso 4 o que no se dio el consentimiento, o que no tienes acceso a ese sitio, biblioteca o lista. 404 itemNotFound significa que el sitio, la biblioteca, la lista o el elemento es incorrecto, o que la ruta del sitio no existe; las cuentas personales de Microsoft reciben 404 o 400 en todas las llamadas. 400 invalidRequest en elementos de listas significa que un nombre de columna no es el nombre interno o que un valor no encaja con la columna; "cannot be referenced in filter or orderby as it is not indexed" significa que la columna necesita un índice en la configuración de la lista. 409 nameAlreadyExists significa que ya hay un elemento con ese nombre en la carpeta.

El conector no descarga el contenido de los archivos, no sube archivos binarios, no crea sitios ni cambia los permisos de los sitios, no elimina listas ni columnas, no edita páginas y no gestiona el almacén de términos ni los tipos de contenido.

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Microsoft SharePoint.

Herramientas disponibles

Ejemplos de prompts

• "Busca el sitio Marketing y enumera los archivos de su biblioteca Documentos que cambiaron este mes."
• "En la lista Proyectos, muéstrame todos los elementos con estado Abierto que vencen antes del viernes."
• "Añade un elemento a la lista Solicitudes de compra: 'Portátiles nuevos para ventas', importe 4.800, estado Pendiente."
• "Busca en SharePoint la política de viajes más reciente y dime dónde está guardada."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

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