BIT OneDrive

Servidor MCP (Model Context Protocol) que conecta Claude con OneDrive a través de Microsoft Graph API para listar, buscar, crear, mover, copiar y compartir archivos directamente desde la conversación.

🛠️ Herramientas disponibles

Herramienta	Descripción
list_files	Lista archivos y carpetas en una ruta
get_file	Obtiene detalles de un archivo o carpeta
create_folder	Crea una carpeta
delete_file	Elimina un archivo o carpeta
move_file	Mueve un archivo a otra carpeta
copy_file	Copia un archivo a otra carpeta
search_files	Busca archivos por nombre o contenido
share_file	Genera enlace para compartir (view/edit, anónimo/org)
get_storage_info	Muestra espacio total, usado y disponible

---

🚀 Instalación

1. Instalar dependencias y compilar

npm install
npm run build

2. Registrar una aplicación en Azure AD

1. Ve a https://portal.azure.com → Azure Active Directory → App registrations → New registration
2. Nombre: Claude OneDrive MCP
3. En API permissions agrega:
   • Files.ReadWrite.All (Application)
   • User.Read.All (Application)
4. Haz clic en Grant admin consent
5. En Certificates & secrets → New client secret → copia el valor

3. Configurar variables de entorno

cp .env.example .env

Edita .env:

TENANT_ID=tu-tenant-id
CLIENT_ID=tu-client-id
CLIENT_SECRET=tu-client-secret
[email protected]

Puedes encontrar el TENANT_ID y CLIENT_ID en la página principal de tu app registrada en Azure AD.

---

🔌 Conectar con Claude Desktop

Edita el archivo de configuración de Claude Desktop:

Windows: %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "onedrive": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["C:\\ruta\\al\\proyecto\\dist\\index.js"],
      "env": {
        "TENANT_ID": "tu-tenant-id",
        "CLIENT_ID": "tu-client-id",
        "CLIENT_SECRET": "tu-client-secret",
        "USER_EMAIL": "[email protected]"
      }
    }
  }
}

Reinicia Claude Desktop y verás las herramientas disponibles.

---

🐛 Troubleshooting

Error 401: Verifica que el CLIENT_SECRET no haya expirado y que se haya otorgado admin consent.

Error 403: Asegúrate de que la app tenga permisos Files.ReadWrite.All con admin consent.

Error 404: Verifica que el USER_EMAIL sea correcto y tenga OneDrive activo.