From 628d5759c5c4861812834a85d248de2313ce28dd Mon Sep 17 00:00:00 2001 From: Jesus Gonzalez Date: Thu, 15 Oct 2026 05:51:05 +0000 Subject: [PATCH 1/2] Document Claude Code MCP servers, RSA keys for Snowflake and Cortex always on --- docs/how-tos/vs-code/external-ai-tools/claude-code.md | 4 +++- .../how-tos/vs-code/external-ai-tools/snowflake-cortex.md | 7 +++---- docs/how-tos/vs-code/initial.mdx | 4 ++++ docs/how-tos/vs-code/mcp/README.md | 4 ++-- docs/how-tos/vs-code/mcp/snowflake.md | 8 +++++--- docs/reference/admin-menu/environments.md | 3 ++- 6 files changed, 19 insertions(+), 11 deletions(-) diff --git a/docs/how-tos/vs-code/external-ai-tools/claude-code.md b/docs/how-tos/vs-code/external-ai-tools/claude-code.md index b2ac585..aa66af4 100644 --- a/docs/how-tos/vs-code/external-ai-tools/claude-code.md +++ b/docs/how-tos/vs-code/external-ai-tools/claude-code.md @@ -67,7 +67,9 @@ If you have problems copying text from Claude Code in the VS Code terminal, run ## MCP servers -Claude Code, the extension and the CLI, can use the Datacoves [Snowflake MCP server](/docs/how-tos/vs-code/mcp/snowflake) when it is enabled for your environment. +Claude Code, the extension and the CLI, can use the Datacoves [MCP servers](/docs/how-tos/vs-code/mcp) (GitHub, Airflow, Grafana, Snowflake) when they are enabled for your environment. The `claude` command in a terminal loads them for you. + +To see them, run `/mcp` inside Claude Code. `claude mcp list` doesn't show the GitHub, Airflow and Grafana servers. ## Learn more diff --git a/docs/how-tos/vs-code/external-ai-tools/snowflake-cortex.md b/docs/how-tos/vs-code/external-ai-tools/snowflake-cortex.md index 1ab149c..7061559 100644 --- a/docs/how-tos/vs-code/external-ai-tools/snowflake-cortex.md +++ b/docs/how-tos/vs-code/external-ai-tools/snowflake-cortex.md @@ -12,10 +12,9 @@ Snowflake's AI coding assistant, available as a CLI tool in Datacoves. ## Prerequisites - A Snowflake-based (`dbt-snowflake`) environment. Cortex is only available on Snowflake - environments. -- Cortex enabled in your Datacoves environment. Contact - [Datacoves support](mailto:support@datacoves.com) to enable it, or an administrator can turn it - on under **Admin > Environments > _your environment_ > AI Tools**. + environments, and it is always on there: the Snowflake VS Code extension's CoCo runs the Cortex + Code CLI, so its switch under **Admin > Environments > _your environment_ > AI Tools** can't be + turned off. ## Login and usage diff --git a/docs/how-tos/vs-code/initial.mdx b/docs/how-tos/vs-code/initial.mdx index 29b80e1..78c0180 100644 --- a/docs/how-tos/vs-code/initial.mdx +++ b/docs/how-tos/vs-code/initial.mdx @@ -200,6 +200,10 @@ If using key based authentication, you will need to provide or generate a key wh Provide or automatically generate your keys. Then add the public key to Snowflake. +:::warning +Elliptic curve keys don't work with the [Snowflake VS Code extension](/docs/getting-started/developer/snowflake-extension) or the [Snowflake MCP server](/docs/how-tos/vs-code/mcp/snowflake). The default **Auto-generate key pairs** creates an elliptic curve key. To use either, pick **Auto-generate RSA key pairs (Compatibility)** or provide an RSA private key. Datacoves shows this warning when you generate, paste, or select an elliptic curve key. +::: +
![Snowflake Settings Generate Keys](./assets/user_settings_snowflake.png)
diff --git a/docs/how-tos/vs-code/mcp/README.md b/docs/how-tos/vs-code/mcp/README.md index acbbcad..800e92b 100644 --- a/docs/how-tos/vs-code/mcp/README.md +++ b/docs/how-tos/vs-code/mcp/README.md @@ -25,11 +25,11 @@ your workspace: - Datacoves Copilot - GitHub Copilot +- [Claude Code](/docs/how-tos/vs-code/external-ai-tools/claude-code), the extension and the CLI - [OpenAI Codex](/docs/how-tos/vs-code/external-ai-tools/openai-codex) - [Snowflake Cortex](/docs/how-tos/vs-code/external-ai-tools/snowflake-cortex) -The Snowflake server also reaches [Claude Code](/docs/how-tos/vs-code/external-ai-tools/claude-code), -the extension and the CLI, and the GitHub Copilot CLI. +The Snowflake server also reaches the GitHub Copilot CLI. ## Enabling MCP servers diff --git a/docs/how-tos/vs-code/mcp/snowflake.md b/docs/how-tos/vs-code/mcp/snowflake.md index 971fb36..d2eb6ef 100644 --- a/docs/how-tos/vs-code/mcp/snowflake.md +++ b/docs/how-tos/vs-code/mcp/snowflake.md @@ -18,9 +18,11 @@ which runs inside your own Snowflake account. Your data never leaves it. - A Snowflake environment whose first Snowflake connection is a development connection, that is, one whose name contains `dev`. -- [Key pair authentication](/docs/how-tos/vs-code/initial) on that connection. Snowflake accepts a - key pair token and nothing else for MCP, so a password-authenticated connection cannot reach the - server. +- [Key pair authentication](/docs/how-tos/vs-code/initial) on that connection, with an RSA key. + Snowflake accepts a key pair token and nothing else for MCP, so a password-authenticated connection + cannot reach the server. The token is signed with RSA, so an elliptic curve key cannot reach it + either. Generate the key with **Auto-generate RSA key pairs (Compatibility)** or provide an RSA + private key. - An MCP server object in your Snowflake account, created by an account administrator as shown below. - The **Snowflake** toggle turned on for your environment by an administrator, under diff --git a/docs/reference/admin-menu/environments.md b/docs/reference/admin-menu/environments.md index ab7a89d..9a2bd13 100644 --- a/docs/reference/admin-menu/environments.md +++ b/docs/reference/admin-menu/environments.md @@ -36,7 +36,8 @@ assistants and the data systems they can reach. It has three sections: - **AI Extensions** - enable or disable the built-in AI extensions, such as Datacoves Copilot and GitHub Copilot. - **AI Tools** - enable or disable the AI CLI tools, such as OpenAI Codex and Snowflake Cortex - (Cortex is only shown on Snowflake environments). + (Cortex is only shown on Snowflake environments, where it is always on because the Snowflake VS + Code extension's CoCo runs it). - **MCP Servers** - enable or disable the [MCP servers](/docs/how-tos/vs-code/mcp) (GitHub, Airflow, Grafana, and Snowflake) that give the AI tools read access to your repositories, DAGs, metrics and logs, and Snowflake data. From 37ce8e859925225b538a1431a955978f7ed1bf83 Mon Sep 17 00:00:00 2001 From: Jesus Gonzalez Date: Thu, 15 Oct 2026 06:01:03 +0000 Subject: [PATCH 2/2] Reword the RSA key prerequisite, say Cortex is always on, drop the Copilot CLI line --- .../how-tos/vs-code/external-ai-tools/snowflake-cortex.md | 4 +--- docs/how-tos/vs-code/mcp/README.md | 2 -- docs/how-tos/vs-code/mcp/snowflake.md | 8 +++----- docs/reference/admin-menu/environments.md | 3 +-- 4 files changed, 5 insertions(+), 12 deletions(-) diff --git a/docs/how-tos/vs-code/external-ai-tools/snowflake-cortex.md b/docs/how-tos/vs-code/external-ai-tools/snowflake-cortex.md index 7061559..90363ca 100644 --- a/docs/how-tos/vs-code/external-ai-tools/snowflake-cortex.md +++ b/docs/how-tos/vs-code/external-ai-tools/snowflake-cortex.md @@ -12,9 +12,7 @@ Snowflake's AI coding assistant, available as a CLI tool in Datacoves. ## Prerequisites - A Snowflake-based (`dbt-snowflake`) environment. Cortex is only available on Snowflake - environments, and it is always on there: the Snowflake VS Code extension's CoCo runs the Cortex - Code CLI, so its switch under **Admin > Environments > _your environment_ > AI Tools** can't be - turned off. + environments, where it is always on. ## Login and usage diff --git a/docs/how-tos/vs-code/mcp/README.md b/docs/how-tos/vs-code/mcp/README.md index 800e92b..5452b84 100644 --- a/docs/how-tos/vs-code/mcp/README.md +++ b/docs/how-tos/vs-code/mcp/README.md @@ -29,8 +29,6 @@ your workspace: - [OpenAI Codex](/docs/how-tos/vs-code/external-ai-tools/openai-codex) - [Snowflake Cortex](/docs/how-tos/vs-code/external-ai-tools/snowflake-cortex) -The Snowflake server also reaches the GitHub Copilot CLI. - ## Enabling MCP servers MCP servers are toggled per environment by an administrator. diff --git a/docs/how-tos/vs-code/mcp/snowflake.md b/docs/how-tos/vs-code/mcp/snowflake.md index d2eb6ef..85ae27d 100644 --- a/docs/how-tos/vs-code/mcp/snowflake.md +++ b/docs/how-tos/vs-code/mcp/snowflake.md @@ -18,11 +18,9 @@ which runs inside your own Snowflake account. Your data never leaves it. - A Snowflake environment whose first Snowflake connection is a development connection, that is, one whose name contains `dev`. -- [Key pair authentication](/docs/how-tos/vs-code/initial) on that connection, with an RSA key. - Snowflake accepts a key pair token and nothing else for MCP, so a password-authenticated connection - cannot reach the server. The token is signed with RSA, so an elliptic curve key cannot reach it - either. Generate the key with **Auto-generate RSA key pairs (Compatibility)** or provide an RSA - private key. +- [Key pair authentication](/docs/how-tos/vs-code/initial) on that connection, using an RSA key. The + MCP server works with RSA key pairs only, not with passwords or elliptic curve keys. To create one, + pick **Auto-generate RSA key pairs (Compatibility)** or provide your own RSA private key. - An MCP server object in your Snowflake account, created by an account administrator as shown below. - The **Snowflake** toggle turned on for your environment by an administrator, under diff --git a/docs/reference/admin-menu/environments.md b/docs/reference/admin-menu/environments.md index 9a2bd13..7af5adb 100644 --- a/docs/reference/admin-menu/environments.md +++ b/docs/reference/admin-menu/environments.md @@ -36,8 +36,7 @@ assistants and the data systems they can reach. It has three sections: - **AI Extensions** - enable or disable the built-in AI extensions, such as Datacoves Copilot and GitHub Copilot. - **AI Tools** - enable or disable the AI CLI tools, such as OpenAI Codex and Snowflake Cortex - (Cortex is only shown on Snowflake environments, where it is always on because the Snowflake VS - Code extension's CoCo runs it). + (Cortex is only shown on Snowflake environments, where it is always on). - **MCP Servers** - enable or disable the [MCP servers](/docs/how-tos/vs-code/mcp) (GitHub, Airflow, Grafana, and Snowflake) that give the AI tools read access to your repositories, DAGs, metrics and logs, and Snowflake data.