mirror of
https://github.com/coder/coder.git
synced 2025-07-23 21:32:07 +00:00
docs: add tutorials for using early access AI agent features (#17186)
Some content is still being merged, but the structure is still there Preview: https://coder.com/docs/@ai-features/tutorials/ai-agents
This commit is contained in:
54
docs/tutorials/ai-agents/headless.md
Normal file
54
docs/tutorials/ai-agents/headless.md
Normal file
@@ -0,0 +1,54 @@
|
||||
> [!NOTE]
|
||||
>
|
||||
> This functionality is in early access and subject to change. Do not run in
|
||||
> production as it is unstable. Instead, deploy these changes into a demo or
|
||||
> staging environment.
|
||||
>
|
||||
> Join our [Discord channel](https://discord.gg/coder) or
|
||||
> [contact us](https://coder.com/contact) to get help or share feedback.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- A Coder deployment with v2.21 or later
|
||||
- A [template configured for AI agents](./create-template.md)
|
||||
|
||||
## Overview
|
||||
|
||||
Once you have an agent running and reporting activity to Coder, you can manage
|
||||
it programmatically via the MCP server, Coder CLI, and/or REST API.
|
||||
|
||||
## MCP Server
|
||||
|
||||
Power users can configure [Claude Desktop](https://claude.ai/download), Cursor,
|
||||
or other tools with MCP support to interact with Coder in order to:
|
||||
|
||||
- List workspaces
|
||||
- Create/start/stop workspaces
|
||||
- Run commands on workspaces
|
||||
- Check in on agent activity
|
||||
|
||||
In this model, an [IDE Agent](./agents.md#in-ide-agents) could interact with a
|
||||
remote Coder workspace, or Coder can be used in a remote pipeline or a larger
|
||||
workflow.
|
||||
|
||||
The Coder CLI has options to automatically configure MCP servers for you. On
|
||||
your local machine, run the following command:
|
||||
|
||||
```sh
|
||||
coder mcp claude-desktop # Configure Claude Desktop to interact with Coder
|
||||
coder mcp cursor # Configure Cursor to interact with Coder
|
||||
```
|
||||
|
||||
## Coder CLI
|
||||
|
||||
Workspaces can be created, started, and stopped via the Coder CLI. See the
|
||||
[CLI docs](../../reference/cli/) for more information.
|
||||
|
||||
## REST API
|
||||
|
||||
The Coder REST API can be used to manage workspaces and agents. See the
|
||||
[API docs](../../reference/api/) for more information.
|
||||
|
||||
## Next Steps
|
||||
|
||||
- [Securing Agents](./securing.md)
|
Reference in New Issue
Block a user