# Sidecars

> Sidecars is one AI workspace for your whole company. This documentation covers the Sidecars MCP server: connecting Claude, Cursor, Codex or any MCP client, OAuth sign-in and scopes, the tools for workspace knowledge, documents, pages, export and comments, example workflows, and troubleshooting.

- [Sidecars MCP server](https://docs.sidecars.ai/index.md): Connect Claude, Cursor, Codex or any MCP client to a Sidecars workspace: one URL, OAuth sign-in, and tools for the workspace's knowledge, documents, pages and comments.
- [Connect your agent](https://docs.sidecars.ai/connect.md): Add the Sidecars MCP server to Claude Code, Claude.ai, Cursor, VS Code, Codex, ChatGPT, Windsurf, Zed or any other host: one URL, OAuth sign-in, no API keys.
- [Agent quickstart](https://docs.sidecars.ai/agent-quickstart.md): The six calls an agent needs on its first task in a Sidecars workspace: connect, find, read, edit, comment, and which id is which.
- [Agent skills](https://docs.sidecars.ai/skills.md): Two installable skills that teach any agent how to work on Sidecars documents and how to write and iterate a plan in one: npx skills add https://docs.sidecars.ai.
- [Authentication and access](https://docs.sidecars.ai/authentication.md): What access a connected agent receives: the OAuth scopes, the one workspace a token names, the document roles that gate each call, and how every action is attributed to you.
- [Available tools](https://docs.sidecars.ai/tools.md): Every operation an agent can run on the Sidecars MCP server, grouped by product area, marked read or write, with the scope each one needs.
- [Example workflows](https://docs.sidecars.ai/workflows.md): Realistic requests to give a connected agent, with the Sidecars tools it will run and the one thing to watch for in each.
- [Troubleshooting](https://docs.sidecars.ai/troubleshooting.md): Every error the Sidecars MCP server returns, keyed on the text you see, with what causes it and how to recover: connection, sign-in and scopes, workspace, permissions, and write conflicts.
- [Knowledge](https://docs.sidecars.ai/reference/knowledge.md): Search the workspace knowledge base for ranked excerpts, or ask it a question and get a sourced answer. Both need only knowledge:read.
- [Conversations](https://docs.sidecars.ai/reference/conversations.md): Turn a room or pod name into the conversation_id and pod_id the document tools take: list the rooms and pods you can reach, by pod, by title, or across the workspace.
- [Documents](https://docs.sidecars.ai/reference/documents.md): List, read, create and edit shared markdown documents while people edit them live, and list their versions; every read returns version and every write returns new_version.
- [Pages](https://docs.sidecars.ai/reference/pages.md): Create, read and rewrite HTML page artifacts; writes require expected_version and return a diff on conflict.
- [Export](https://docs.sidecars.ai/reference/export.md): Render a document, page or table to markdown, PDF, HTML, CSV or JSON and fetch it through a 15-minute download URL.
- [Comments](https://docs.sidecars.ai/reference/comments.md): Read, start, reply to and resolve comment threads on a document or page, with anchored quotes and agent mentions.
- [Resources](https://docs.sidecars.ai/reference/resources.md): Mount workspace documents as sidecars://document/{id} resources, how the listing is filtered, and why there are no prompts.
- [Artifact URLs, IDs and Copy for agent](https://docs.sidecars.ai/reference/artifacts.md): How an artifact's URL, document_id and sidecars:// URI relate, the artifact kinds and versions, and the Copy for agent handoff format.