Skip to content

docs(snowflake): add Snowflake auth provider page - #1115

Open
avoguru wants to merge 4 commits into
mainfrom
docs/snowflake-auth-provider-and-toolkit
Open

docs(snowflake): add Snowflake auth provider page#1115
avoguru wants to merge 4 commits into
mainfrom
docs/snowflake-auth-provider-and-toolkit

Conversation

@avoguru

@avoguru avoguru commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Scoped to the auth provider docs only, now that the auto-generated toolkit docs have merged.

Snowflake is set up as a custom OAuth 2.0 provider, because its OAuth endpoints are specific to each account. This page covers that: creating the security integration in Snowflake, registering it in Arcade, setting the SNOWFLAKE_ACCOUNT_SUBDOMAIN secret, and giving each person a role.

Each end user signs in to Snowflake themselves, so every query runs under that user's own role.

Also adds the provider to the auth-providers catalog page.

🤖 Generated with Claude Code


Note

Low Risk
Documentation and integrations index display logic only; no auth runtime or API behavior changes.

Overview
Adds a Snowflake auth provider reference page and lists it on the auth-providers catalog with a card linking to /references/auth-providers/snowflake.

The new guide walks through per-user OAuth via a Snowflake security integration (provider ID snowflake), Arcade custom OAuth endpoints (/oauth/token-request), the SNOWFLAKE_ACCOUNT_SUBDOMAIN secret, role grants, MCP gateway usage, and a sample OAuth2(id="snowflake") tool.

On the integrations index, resolveIndexToolkits now sets isComingSoon: !hasPage so shipped toolkits with docs are not stuck behind a stale design-system flag; toolkits-client passes isComingSoon from that resolved value only.

public/llms.txt is regenerated to include the Snowflake auth provider link.

Reviewed by Cursor Bugbot for commit 52256e0. Bugbot is set up for automated code reviews on this repo. Configure here.

@vercel

vercel Bot commented Aug 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 6, 2026 6:34pm

Request Review

Snowflake is configured as a custom OAuth 2.0 provider, since its OAuth
endpoints are specific to each account. This documents that setup: creating
the security integration in Snowflake, registering it in Arcade, setting the
account subdomain secret, and giving each person a role.

Each end user signs in to Snowflake themselves, so every query runs under
that user's own role, with no shared service account.

Adds the provider to the auth-providers catalog page. The sidebar title
resolves from the page frontmatter and sorts alphabetically, so no
_meta.tsx change is needed.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@avoguru
avoguru force-pushed the docs/snowflake-auth-provider-and-toolkit branch from 45a7274 to fa526c2 Compare August 6, 2026 17:10
@avoguru avoguru changed the title docs(snowflake): add auth provider and MCP server pages docs(snowflake): add Snowflake auth provider page Aug 6, 2026
The index took `isComingSoon` from the design-system catalog, a
hand-maintained constant in a published package. It goes stale the moment a
toolkit ships, so a live toolkit keeps rendering as an unavailable card.
Snowflake is in that state now: its docs generated and merged in #1114, but
the tile still reads "Coming soon".

Resolve the flag in `resolveIndexToolkits` from `hasPage` instead. The badge
means "there is nothing to read yet", which is exactly what `hasPage`
already answers, and the value no longer depends on a package release.

This also makes the badge and the sort order agree. `use-toolkit-filters`
sorted on the raw design-system flag while the card rendered on
`isComingSoon || !hasPage`, so seven toolkits (CloseIO, Discord,
GoogleForms, Notion, Obsidian, Twilio, Twitch) showed a "Coming soon" badge
while sorting among the available ones. They now sort with the other
unavailable toolkits.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
// unavailable. Deriving it here also keeps the badge and the sort order
// (`use-toolkit-filters`) reading the same value, which they previously
// did not.
resolved.push({ ...toolkit, hasPage, isComingSoon: !hasPage });

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice

@avoguru
avoguru removed the request for review from samkujovich August 6, 2026 19:24
@avoguru avoguru closed this Aug 6, 2026
@avoguru avoguru reopened this Aug 6, 2026
The previous head was pushed by github-actions[bot] while regenerating
llms.txt. Pushes made with the default GITHUB_TOKEN do not emit a
workflow trigger, so the required test and validate_schemas checks never
ran against that commit and the PR could not merge despite approval.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants