stackgate.ai
Alle integrationer

Google Drive

Filer og mapper i Google Drive.

OAuth 5 værktøjer

Overblik

Gennemse og download filer fra Google Drive via AI-klienter.

Forudsætninger

  • En Google-konto med Drive
  • En stackgate.ai-konto

Credentials

  1. Gå til Mine integrationer → Google Drive i stackgate.ai.
  2. Klik Aktivér, og derefter Forbind Google Drive.
  3. Log ind med Google, og godkend den anmodede Drive-scope (drive.readonly).
  4. Vælg hvilke mapper AI-klienter må tilgå (My Drive root og/eller specifikke mapper).

stackgate.ai bruger den samme Google OAuth-app som Gmail, Google Calendar og Search Console, hvor det er relevant.

Scopes og tilbagekaldelse

  • Scope: https://www.googleapis.com/auth/drive.readonly — read-only adgang til filer og eksporter; ingen upload eller sletning.
  • Tilbagekaldelse: afbryd Google Drive på integrationssiden, eller tilbagekald stackgate.ai i dine Google Account permissions.

Mappevalg

Efter OAuth vælger du My Drive og/eller individuelle topniveau-mapper. MCP-værktøjer søger og downloader kun inden for aktiverede mapper. Opdater mappelisten fra Google, når du tilføjer nye topniveau-mapper.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/drive
  • Private gateway: drive__*-værktøjer

Se Dokumentation for HTTP-autentificering og opsætning af private gateway.

Eksempel-prompts

  • "Search my Drive for PDFs about Q4 budget."
  • "List files in the folder I enabled for MCP."
  • "Get metadata for file ID 1abc… and export the Google Doc as PDF."
  • "Download this spreadsheet and store it in Temp Storage for WordPress upload."

Sæt mode=temp-storage på download_file for at gemme en fil i Temp Storage og modtage et file_id til tværgående overdragelse. Udelad mode eller brug mode=download for inline bytes eller et resource link. Kræver at Temp Storage er aktiveret under Mine integrationer.

Filer under 10 MB returnerer indlejret binært indhold; større filer returnerer et resource_link — hent bytes med resources/read.

Fejlfinding

  • File not found — bekræft at filen ligger i en mappe, du har aktiveret, og at den forbundne konto har adgang.
  • No folders enabled — åbn mappepræferencer på integrationssiden, og aktiver mindst én mappe.
  • Insufficient scopes — afbryd og genforbind Google Drive for at opdatere OAuth-tilladelser.
  • Export errors — nogle Google Workspace-filtyper understøtter kun specifikke eksportformater (PDF, XLSX osv.).

Tilgængelige værktøjer

  • list_folders

    List Google Drive folders enabled for MCP access in My Integrations.

  • search_files

    Search files in Google Drive using Google Drive query syntax within folders enabled in My Integrations.

  • list_files

    List files in Google Drive within folders enabled in My Integrations. Optional query uses Google Drive search syntax.

  • get_file_metadata

    Get metadata for a Google Drive file by ID within folders enabled in My Integrations.

  • download_file

    Download or export a Google Drive file. Google Workspace files are exported (PDF, XLSX, etc.). Default mode returns inline bytes for files under 10 MB or a resource_link for larger files. Use mode=temp-storage to store in temp storage and receive a file_id for cross handoff.

MCP-endpoint: https://stackgate.ai/mcp/drive (HTTP) eller via private gateway.

Opret konto Dokumentation