diff --git a/docs/connectors.md b/docs/connectors.md index e653a57..693c25e 100644 --- a/docs/connectors.md +++ b/docs/connectors.md @@ -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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 diff --git a/docs/connectors/gmail-setup.md b/docs/connectors/gmail-setup.md index 75d37f3..8d904b6 100644 --- a/docs/connectors/gmail-setup.md +++ b/docs/connectors/gmail-setup.md @@ -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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 [support@paperclip.ing](mailto:support@paperclip.ing) 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. diff --git a/docs/connectors/gmail.md b/docs/connectors/gmail.md index 0ac6ded..20b8f6e 100644 --- a/docs/connectors/gmail.md +++ b/docs/connectors/gmail.md @@ -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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 [support@paperclip.ing](mailto:support@paperclip.ing) 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. diff --git a/docs/connectors/google-calendar.md b/docs/connectors/google-calendar.md index 42fb0d4..317cc5f 100644 --- a/docs/connectors/google-calendar.md +++ b/docs/connectors/google-calendar.md @@ -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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 [support@paperclip.ing](mailto:support@paperclip.ing) 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) diff --git a/docs/connectors/google-chat.md b/docs/connectors/google-chat.md index 707b743..d495d74 100644 --- a/docs/connectors/google-chat.md +++ b/docs/connectors/google-chat.md @@ -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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 [support@paperclip.ing](mailto:support@paperclip.ing) 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. diff --git a/docs/connectors/google-docs.md b/docs/connectors/google-docs.md index 4301eae..61019eb 100644 --- a/docs/connectors/google-docs.md +++ b/docs/connectors/google-docs.md @@ -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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 [support@paperclip.ing](mailto:support@paperclip.ing) if you cannot connect. Agents can read the text and structure of Google Docs documents, and on an editing connection update them. diff --git a/docs/connectors/google-drive.md b/docs/connectors/google-drive.md index 8e829f6..deef2d0 100644 --- a/docs/connectors/google-drive.md +++ b/docs/connectors/google-drive.md @@ -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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 [support@paperclip.ing](mailto:support@paperclip.ing) 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. diff --git a/docs/connectors/google-people.md b/docs/connectors/google-people.md index 5d13385..43c2de5 100644 --- a/docs/connectors/google-people.md +++ b/docs/connectors/google-people.md @@ -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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 [support@paperclip.ing](mailto:support@paperclip.ing) if you cannot connect. Agents can search your Google contacts, search your organization's Workspace directory, and read your own profile. diff --git a/docs/connectors/google-setup.md b/docs/connectors/google-setup.md index d8825e8..8403bef 100644 --- a/docs/connectors/google-setup.md +++ b/docs/connectors/google-setup.md @@ -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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 [support@paperclip.ing](mailto:support@paperclip.ing) 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. diff --git a/docs/connectors/google-sheets.md b/docs/connectors/google-sheets.md index 3b35b49..d98ff0b 100644 --- a/docs/connectors/google-sheets.md +++ b/docs/connectors/google-sheets.md @@ -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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 [support@paperclip.ing](mailto:support@paperclip.ing) if you cannot connect. Agents can read spreadsheet values and structure, and on a writing connection update them. diff --git a/docs/connectors/google-slides.md b/docs/connectors/google-slides.md index 7416f73..fba533a 100644 --- a/docs/connectors/google-slides.md +++ b/docs/connectors/google-slides.md @@ -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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 [support@paperclip.ing](mailto:support@paperclip.ing) if you cannot connect. Agents can read the slides and content of a Google Slides presentation, and on an editing connection update it. diff --git a/docs/connectors/google-workspace-search.md b/docs/connectors/google-workspace-search.md index 1026057..2643d12 100644 --- a/docs/connectors/google-workspace-search.md +++ b/docs/connectors/google-workspace-search.md @@ -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 [support@paperclip.ing](mailto:support@paperclip.ing) 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 [support@paperclip.ing](mailto:support@paperclip.ing) 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. diff --git a/docs/connectors/slack.md b/docs/connectors/slack.md index a925265..649f24a 100644 --- a/docs/connectors/slack.md +++ b/docs/connectors/slack.md @@ -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. diff --git a/docs/reference/adapters/sandbox-providers.md b/docs/reference/adapters/sandbox-providers.md index 30ba9c7..f680429 100644 --- a/docs/reference/adapters/sandbox-providers.md +++ b/docs/reference/adapters/sandbox-providers.md @@ -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. --- diff --git a/docs/reference/cli/overview.md b/docs/reference/cli/overview.md index 9ca6cd4..cdf9441 100644 --- a/docs/reference/cli/overview.md +++ b/docs/reference/cli/overview.md @@ -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. ---