docs: clarify connector availability and clean review preview

2026-11-07 06:16:07 -10:00 · 2026-09-16 19:14:30 -07:00
1 parent fd80b64a0d
commit c8d023893d
@@ -9,7 +9,7 @@ A **connector** is a saved connection to an outside service: a Gmail mailbox, a

 > **Note:** These guides cover the connector model in Paperclip **v2026.916.0**. Available methods depend on your installed version, instance configuration, and provider approval. A catalog listing does not by itself establish that provider sign-in is available.

-> **Warning:** New Google connector setup is paused while Paperclip completes Google verification, as [announced on September 16, 2026](https://x.com/papercliping/status/2100341600098693205). Google setup guides remain available as reference material, not a workaround for the pause. Check that announcement for updates or contact [[email protected]](mailto:[email protected]) before starting a new connection.
+> **Warning:** **Google verification pending.** Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an **Advanced** option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [[email protected]](mailto:[email protected]) if you cannot connect.

 ## Start here

@@ -61,7 +61,7 @@ Find an app and open its setup guide.
 | [Google Slides](connectors/google-slides.md) | Google's presentations. Agents read decks, and on a write connection edit them. | Connect with Paperclip · Your own OAuth app |
 | [Google Workspace Search](connectors/google-workspace-search.md) | One read-only search that spans Gmail, Drive, Calendar, and Chat in a single Google account. Use it when an agent needs to find something without knowing which app holds it. | Connect with Paperclip · Your own OAuth app |

-> **Warning:** **Pending Google verification.** New Google connector setup is paused. You may encounter an unverified-app warning or an access-blocked screen; an **Advanced** option is not a universal way to continue. Do not treat it as a workaround for the pause. See [Google setup requirements](connectors/google-setup.md) for availability updates and the separate Developer Preview prerequisites. [Google's OAuth guidance](https://developers.google.com/identity/protocols/oauth2/production-readiness/overview) explains how verification, testing status, and Workspace administrator restrictions affect authorization.
+> **Note:** Google app verification is pending. See [Google setup requirements](connectors/google-setup.md) for unverified-app warnings, account restrictions, and the separate Developer Preview prerequisites.

 ### Productivity and collaboration

@@ -5,7 +5,7 @@ seo_description: Get Google Developer Preview access, connect Gmail with the rea

 # Set up the Gmail connector

-> **Warning:** New Google connector setup is paused while Paperclip completes Google verification, as [announced on September 16, 2026](https://x.com/papercliping/status/2100341600098693205). The setup instructions below are reference material, not a workaround for the pause. Check that announcement for updates or contact [[email protected]](mailto:[email protected]) before starting a new connection.
+> **Warning:** **Google verification pending.** Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an **Advanced** option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [[email protected]](mailto:[email protected]) if you cannot connect.

 Two phases: get Google to register you for Developer Preview, then connect. The first phase is the slow one and happens entirely at Google.

@@ -5,7 +5,7 @@ seo_description: Let agents search and read Gmail, and optionally draft replies.

 # Gmail

-> **Warning:** New Google connector setup is paused while Paperclip completes Google verification, as [announced on September 16, 2026](https://x.com/papercliping/status/2100341600098693205). The setup instructions below are reference material, not a workaround for the pause. Check that announcement for updates or contact [[email protected]](mailto:[email protected]) before starting a new connection.
+> **Warning:** **Google verification pending.** Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an **Advanced** option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [[email protected]](mailto:[email protected]) if you cannot connect.

 Agents can search and read your Gmail, and on a draft connection leave drafts in your drafts folder for you to review. Sending is not reachable through this connector.

@@ -5,7 +5,7 @@ seo_description: Let agents read calendars and availability, and optionally mana

 # Google Calendar

-> **Warning:** New Google connector setup is paused while Paperclip completes Google verification, as [announced on September 16, 2026](https://x.com/papercliping/status/2100341600098693205). The setup instructions below are reference material, not a workaround for the pause. Check that announcement for updates or contact [[email protected]](mailto:[email protected]) before starting a new connection.
+> **Warning:** **Google verification pending.** Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an **Advanced** option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [[email protected]](mailto:[email protected]) if you cannot connect.

 Agents can read the calendars on your Google account, look up events, and check availability. On a managing connection they can also create, update, delete, and respond to events.

@@ -81,4 +81,4 @@ Limitations: one connection covers one Google account. Calendar sharing and acce
 - [Google Workspace Search](google-workspace-search.md) — one read-only search across Gmail, Drive, Calendar, and Chat.
 - [How connector access works](access-model.md)
 - [Verify a connector and fix a broken one](verify-and-troubleshoot.md)
- [Google Calendar API MCP reference](https://developers.google.com/workspace/calendar/api/reference/mcp)
+- [Google Calendar API MCP reference](https://developers.google.com/workspace/calendar/api/v3/reference/mcp)
@@ -5,7 +5,7 @@ seo_description: Let agents search and read Google Chat conversations, and optio

 # Google Chat

-> **Warning:** New Google connector setup is paused while Paperclip completes Google verification, as [announced on September 16, 2026](https://x.com/papercliping/status/2100341600098693205). The setup instructions below are reference material, not a workaround for the pause. Check that announcement for updates or contact [[email protected]](mailto:[email protected]) before starting a new connection.
+> **Warning:** **Google verification pending.** Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an **Advanced** option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [[email protected]](mailto:[email protected]) if you cannot connect.

 Agents can search Google Chat conversations and read messages, and on a sending connection post messages to spaces the authorizing account belongs to.

@@ -5,7 +5,7 @@ seo_description: Let agents read Google Docs documents and optionally update the

 # Google Docs

-> **Warning:** New Google connector setup is paused while Paperclip completes Google verification, as [announced on September 16, 2026](https://x.com/papercliping/status/2100341600098693205). The setup instructions below are reference material, not a workaround for the pause. Check that announcement for updates or contact [[email protected]](mailto:[email protected]) before starting a new connection.
+> **Warning:** **Google verification pending.** Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an **Advanced** option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [[email protected]](mailto:[email protected]) if you cannot connect.

 Agents can read the text and structure of Google Docs documents, and on an editing connection update them.

@@ -5,7 +5,7 @@ seo_description: Let agents search and read Drive files, and optionally create o

 # Google Drive

-> **Warning:** New Google connector setup is paused while Paperclip completes Google verification, as [announced on September 16, 2026](https://x.com/papercliping/status/2100341600098693205). The setup instructions below are reference material, not a workaround for the pause. Check that announcement for updates or contact [[email protected]](mailto:[email protected]) before starting a new connection.
+> **Warning:** **Google verification pending.** Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an **Advanced** option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [[email protected]](mailto:[email protected]) if you cannot connect.

 Agents can search Drive, read file metadata and content, and on a creating connection add new files or copy existing ones.

@@ -5,7 +5,7 @@ seo_description: Let agents look up contacts and Workspace directory profiles. R

 # Google People

-> **Warning:** New Google connector setup is paused while Paperclip completes Google verification, as [announced on September 16, 2026](https://x.com/papercliping/status/2100341600098693205). The setup instructions below are reference material, not a workaround for the pause. Check that announcement for updates or contact [[email protected]](mailto:[email protected]) before starting a new connection.
+> **Warning:** **Google verification pending.** Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an **Advanced** option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [[email protected]](mailto:[email protected]) if you cannot connect.

 Agents can search your Google contacts, search your organization's Workspace directory, and read your own profile.

@@ -5,7 +5,7 @@ seo_description: One reusable procedure for connecting any Google Workspace conn

 # Set up your own Google OAuth app

-> **Warning:** New Google connector setup is paused while Paperclip completes Google verification, as [announced on September 16, 2026](https://x.com/papercliping/status/2100341600098693205). The setup instructions below are reference material, not a workaround for the pause. Check that announcement for updates or contact [[email protected]](mailto:[email protected]) before starting a new connection.
+> **Warning:** **Google verification pending.** Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an **Advanced** option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [[email protected]](mailto:[email protected]) if you cannot connect.

 Nine connectors in this catalog talk to Google Workspace: Gmail, Calendar, Chat, Docs, Drive, People, Sheets, Slides, and Workspace Search. Connecting any of them with **your own** OAuth client follows the shared steps below, and this page is that procedure.

@@ -5,7 +5,7 @@ seo_description: Two ways to connect Google Sheets: a Google sign-in, or sharing

 # Google Sheets

-> **Warning:** New Google connector setup is paused while Paperclip completes Google verification, as [announced on September 16, 2026](https://x.com/papercliping/status/2100341600098693205). The setup instructions below are reference material, not a workaround for the pause. Check that announcement for updates or contact [[email protected]](mailto:[email protected]) before starting a new connection.
+> **Warning:** **Google verification pending.** Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an **Advanced** option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [[email protected]](mailto:[email protected]) if you cannot connect.

 Agents can read spreadsheet values and structure, and on a writing connection update them.

@@ -5,7 +5,7 @@ seo_description: Let agents read Google Slides presentations and optionally upda

 # Google Slides

-> **Warning:** New Google connector setup is paused while Paperclip completes Google verification, as [announced on September 16, 2026](https://x.com/papercliping/status/2100341600098693205). The setup instructions below are reference material, not a workaround for the pause. Check that announcement for updates or contact [[email protected]](mailto:[email protected]) before starting a new connection.
+> **Warning:** **Google verification pending.** Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an **Advanced** option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [[email protected]](mailto:[email protected]) if you cannot connect.

 Agents can read the slides and content of a Google Slides presentation, and on an editing connection update it.

@@ -5,7 +5,7 @@ seo_description: One read-only search across Gmail, Drive, Calendar, and Chat. W

 # Google Workspace Search

-> **Warning:** New Google connector setup is paused while Paperclip completes Google verification, as [announced on September 16, 2026](https://x.com/papercliping/status/2100341600098693205). The setup instructions below are reference material, not a workaround for the pause. Check that announcement for updates or contact [[email protected]](mailto:[email protected]) before starting a new connection.
+> **Warning:** **Google verification pending.** Paperclip has not yet completed Google app verification. You may see an unverified-app warning during authorization. If Google offers an **Advanced** option to continue to Paperclip, you can choose to proceed after reviewing the requested access. This option is not available for every account; Workspace administrator restrictions and other Google access requirements still apply. Contact [[email protected]](mailto:[email protected]) if you cannot connect.

 One read-only search that spans Gmail, Drive, Calendar, and Chat together, so an agent can answer "where did we discuss this?" without knowing which app holds the answer.

@@ -7,6 +7,8 @@ seo_description: Two independent Slack setups: Slack as an agent tool, or as a c

 Slack does two unrelated jobs in Paperclip, and they are separate connections with separate credentials.

+> **Warning:** Slack is available, but it is not yet fully functional. Follow-up fixes are planned. Review the agent-tool limitations below before relying on it for production work; the separate chat-channel route is experimental.
+
 ## Which do you want?

 | If you want | Set up | What it gives you |
@@ -24,7 +26,7 @@ An agent uses a Slack workspace credential to search messages, read channel list

 ### Agent-tool compatibility notice

-**Do not use the Slack agent-tool setup in v2026.916.0 as a supported production path yet.** That release configures OAuth endpoints and scopes that differ from Slack's current hosted MCP requirements. A successful bot installation does not verify an MCP connection.
+**The Slack agent-tool route is available but has known compatibility limitations in v2026.916.0.** That release configures OAuth endpoints and scopes that differ from Slack's current hosted MCP requirements. A successful bot installation does not verify an MCP connection.

 Slack MCP requires a registered internal or marketplace-published app, user-token OAuth endpoints, and the user scopes for the intended tools. See [Slack's MCP authentication requirements](https://docs.slack.dev/ai/slack-mcp-server/). Bot-token setup is for the separate chat-channel path below.

@@ -10,7 +10,7 @@ Sandbox provider plugins let Paperclip provision external compute as the executi

 A sandbox provider plugin registers an `environmentDriver` of kind `sandbox_provider`. Once installed, the provider is available when you configure a sandbox environment under **Settings → Instance settings → Environments**.

-> ⚠ TODO: expand each provider section with a full `configSchema` field reference once a stable cross-provider schema reference is published. The fields below come from each provider's `README.md` in the parent repo at `v2026.512.0`.
+> **Note:** This overview covers selected configuration fields, not a complete schema reference. The fields below come from each provider's `README.md` in the parent repo at `v2026.512.0`; check your installed provider's documentation for its complete configuration.

 ---

@@ -194,7 +194,7 @@ If you'd rather follow a path than read a reference, these product guides cover
 - The org: [Org structure](../../guides/org/org-structure.md) · [Delegation](../../guides/org/delegation.md) · [Projects](../../guides/projects-workflow/projects.md) · [Goals](../../guides/projects-workflow/goals.md) · [Routines](../../guides/projects-workflow/routines.md)
 - Credentials: [CLI auth](../../administration/cli-auth.md)

-> **Coming soon:** a dedicated CLI-operator track — driving and bootstrapping a whole company from the terminal, including handing the CLI to an AI operator — is being written. For now the command pages above plus these guides cover the full surface.
+To manage a company from the terminal, use the command reference above alongside these guides.

 ---