# Azure Cosmos DB Shell

> Documentation index for AI assistants using Azure Cosmos DB Shell, a preview command-line interface with optional Model Context Protocol (MCP) integration.

This index covers Shell documentation, not the full Azure Cosmos DB documentation set. Shell MCP can perform database operations under the configured identity and permissions. Reading documentation doesn't authenticate an assistant or grant database access. Review tool calls before approving them, and don't share credentials or sensitive data.

## Guides

- [Documentation home](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/): Guide directory and preview status.
- [Overview](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/overview): Capabilities, requirements, and installation options.
- [Installation](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/install): Extension, .NET tool, and binary installation methods.
- [Get started](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/get-started): Connect, navigate, and use basic commands.
- [Command reference](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/command-reference): Command syntax, options, and examples, including data-changing operations.
- [Visual Studio Code](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/visual-studio-code): Extension workflows and configuration.
- [Shell MCP setup](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/model-context-protocol-setup): Configure database-tool integration, authentication, and server settings.
- [Security](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/security): Authentication, permissions, credential handling, and MCP precautions.
- [Troubleshooting](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/troubleshooting): Installation, connection, command, extension, and MCP diagnostics.

## Markdown versions

- [Documentation home as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/?accept=text/markdown): Machine-readable guide directory.
- [Overview as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/overview?accept=text/markdown): Machine-readable capabilities and requirements.
- [Installation as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/install?accept=text/markdown): Machine-readable installation instructions.
- [Get started as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/get-started?accept=text/markdown): Machine-readable first-session instructions.
- [Command reference as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/command-reference?accept=text/markdown): Machine-readable command reference.
- [Visual Studio Code as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/visual-studio-code?accept=text/markdown): Machine-readable extension instructions.
- [Shell MCP setup as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/model-context-protocol-setup?accept=text/markdown): Machine-readable database-tool setup.
- [Security as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/security?accept=text/markdown): Machine-readable security guidance.
- [Troubleshooting as Markdown](https://learn.microsoft.com/en-us/azure/cosmos-db/shell/troubleshooting?accept=text/markdown): Machine-readable troubleshooting guidance.

## Documentation tools

- [Microsoft Learn MCP server](https://learn.microsoft.com/en-us/training/support/mcp): Search documentation and retrieve articles; distinct from Shell MCP and doesn't provide database access.
- [Connect to Learn MCP in Visual Studio Code](https://learn.microsoft.com/en-us/training/support/mcp-get-started): Documentation-retrieval setup for compatible assistants.

## Optional

- [Azure Cosmos DB Agent Kit](https://learn.microsoft.com/en-us/azure/cosmos-db/gen-ai/agent-kit/overview): Agent skills for Azure Cosmos DB guidance; separate from Shell database-tool integration.
- [Microsoft Learn crawler policy](https://learn.microsoft.com/robots.txt): Host-level crawler rules. This index doesn't change crawler permissions or content-use policy.