Skip to content

Commit 41cd780

Browse files
shykesshykes
committed
Docs: split integrations pages
Signed-off-by: Solomon Hykes <solomon@dagger.io>
1 parent f2fea62 commit 41cd780

7 files changed

Lines changed: 726 additions & 1 deletion

File tree

‎docs/amazon-q.mdx‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
title: Amazon Q Developer
3+
description: "Setup guide for Amazon Q Developer with Container Use"
4+
icon: robot
5+
---
6+
7+
## Add MCP Configuration
8+
9+
Add this configuration to `~/.aws/amazonq/mcp.json`:
10+
11+
```json
12+
{
13+
"mcpServers": {
14+
"container-use": {
15+
"command": "cu",
16+
"args": ["stdio"],
17+
"env": {},
18+
"timeout": 60000
19+
}
20+
}
21+
}
22+
```
23+
24+
## Add Agent Rules
25+
26+
Save agent instructions to your project root:
27+
28+
```sh
29+
mkdir -p ./.amazonq/rules && curl https://raw.githubusercontent.com/dagger/container-use/main/rules/agent.md > .amazonq/rules/container-use.md
30+
```
31+
32+
## Trust Only Container Use Tools (Optional)
33+
34+
```sh
35+
q chat --trust-tools=container_use___environment_checkpoint,container_use___environment_file_delete,container_use___environment_file_list,container_use___environment_file_read,container_use___environment_file_write,container_use___environment_open,container_use___environment_run_cmd,container_use___environment_update
36+
```
37+
38+
<Card title="Video Tutorial" icon="youtube" href="https://youtu.be/C2g3vdbffOI">
39+
Watch the Amazon Q Developer setup walkthrough
40+
</Card>
41+
42+
## Verification
43+
44+
After setting up Amazon Q Developer, verify Container Use is working:
45+
46+
1. **Check MCP Connection**: Amazon Q should recognize Container Use tools
47+
2. **Test Environment Creation**: Ask Amazon Q to create a new environment
48+
3. **Verify Isolation**: Multiple environments should work independently
49+
50+
## Troubleshooting
51+
52+
<AccordionGroup>
53+
<Accordion title="Amazon Q doesn't recognize Container Use">
54+
- Verify the `cu` command is in your PATH: `which cu`
55+
- Check MCP configuration syntax
56+
- Restart Amazon Q after configuration changes
57+
</Accordion>
58+
59+
<Accordion title="Permission errors">
60+
- Ensure Docker is running and accessible
61+
- Check file permissions for configuration files
62+
- Verify `cu stdio` command works: `echo '{}' | cu stdio`
63+
</Accordion>
64+
65+
<Accordion title="Tools not appearing">
66+
- Check your Amazon Q MCP server logs
67+
- Verify Container Use tools are enabled in settings
68+
</Accordion>
69+
</AccordionGroup>
70+
71+
## Next Steps
72+
73+
<CardGroup cols={2}>
74+
<Card title="Back to Quickstart" icon="rocket" href="/quickstart">
75+
Return to the quickstart guide to create your first environment
76+
</Card>
77+
<Card
78+
title="Join Community"
79+
icon="discord"
80+
href="https://discord.gg/YXbtwRQv"
81+
>
82+
Get help and share experiences in #container-use
83+
</Card>
84+
</CardGroup>

‎docs/claude-code.mdx‎

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
---
2+
title: Claude Code
3+
description: "Setup guide for Claude Code with Container Use"
4+
icon: robot
5+
---
6+
7+
## Install Claude Code
8+
9+
```sh
10+
npm install -g @anthropic-ai/claude-code
11+
```
12+
13+
## Add MCP Configuration
14+
15+
```sh
16+
cd /path/to/repository
17+
claude mcp add container-use -- <full path to cu command> stdio
18+
```
19+
20+
## Add Agent Rules (Optional)
21+
22+
Save the CLAUDE.md file at the root of your repository:
23+
24+
```sh
25+
curl https://raw.githubusercontent.com/dagger/container-use/main/rules/agent.md >> CLAUDE.md
26+
```
27+
28+
## Trust Only Container Use Tools (Optional)
29+
30+
For maximum security, restrict Claude Code to only use Container Use tools:
31+
32+
```sh
33+
claude --allowedTools mcp__container-use__environment_checkpoint,mcp__container-use__environment_create,mcp__container-use__environment_add_service,mcp__container-use__environment_file_delete,mcp__container-use__environment_file_list,mcp__container-use__environment_file_read,mcp__container-use__environment_file_write,mcp__container-use__environment_open,mcp__container-use__environment_run_cmd,mcp__container-use__environment_update
34+
```
35+
36+
<Info>
37+
Learn more: [Claude Code MCP
38+
Documentation](https://docs.anthropic.com/en/docs/claude-code/tutorials#set-up-model-context-protocol-mcp)
39+
</Info>
40+
41+
## Verification
42+
43+
After setting up Claude Code, verify Container Use is working:
44+
45+
1. **Check MCP Connection**: Claude Code should recognize Container Use tools
46+
2. **Test Environment Creation**: Ask Claude Code to create a new environment
47+
3. **Verify Isolation**: Multiple environments should work independently
48+
49+
## Troubleshooting
50+
51+
<AccordionGroup>
52+
<Accordion title="Claude Code doesn't recognize Container Use">
53+
- Verify the `cu` command is in your PATH: `which cu`
54+
- Check MCP configuration syntax
55+
- Restart Claude Code after configuration changes
56+
</Accordion>
57+
58+
<Accordion title="Permission errors">
59+
- Ensure Docker is running and accessible
60+
- Check file permissions for configuration files
61+
- Verify `cu stdio` command works: `echo '{}' | cu stdio`
62+
</Accordion>
63+
64+
<Accordion title="Tools not appearing">
65+
- Check your Claude Code MCP server logs
66+
- Verify Container Use tools are enabled in settings
67+
</Accordion>
68+
</AccordionGroup>
69+
70+
## Next Steps
71+
72+
<CardGroup cols={2}>
73+
<Card title="Back to Quickstart" icon="rocket" href="/quickstart">
74+
Return to the quickstart guide to create your first environment
75+
</Card>
76+
<Card
77+
title="Join Community"
78+
icon="discord"
79+
href="https://discord.gg/YXbtwRQv"
80+
>
81+
Get help and share experiences in #container-use
82+
</Card>
83+
</CardGroup>

‎docs/cursor.mdx‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: Cursor
3+
description: "Setup guide for Cursor with Container Use"
4+
icon: robot
5+
---
6+
7+
## Install MCP Server
8+
9+
Use the one-click deeplink to install (requires Cursor and Container Use already installed):
10+
11+
[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=container-use&config=eyJjb21tYW5kIjoiY3Ugc3RkaW8ifQ%3D%3D)
12+
13+
## Add Agent Rules
14+
15+
Add the rules file to your project or home directory:
16+
17+
```sh
18+
curl --create-dirs -o .cursor/rules/container-use.mdc https://raw.githubusercontent.com/dagger/container-use/main/rules/cursor.mdc
19+
```
20+
21+
<Info>
22+
Learn more: [Cursor MCP
23+
Documentation](https://docs.cursor.com/context/model-context-protocol)
24+
</Info>
25+
26+
## Verification
27+
28+
After setting up Cursor, verify Container Use is working:
29+
30+
1. **Check MCP Connection**: Cursor should recognize Container Use tools
31+
2. **Test Environment Creation**: Ask Cursor to create a new environment
32+
3. **Verify Isolation**: Multiple environments should work independently
33+
34+
## Troubleshooting
35+
36+
<AccordionGroup>
37+
<Accordion title="Cursor doesn't recognize Container Use">
38+
- Verify the `cu` command is in your PATH: `which cu`
39+
- Check MCP configuration syntax
40+
- Restart Cursor after configuration changes
41+
</Accordion>
42+
43+
<Accordion title="Permission errors">
44+
- Ensure Docker is running and accessible
45+
- Check file permissions for configuration files
46+
- Verify `cu stdio` command works: `echo '{}' | cu stdio`
47+
</Accordion>
48+
49+
<Accordion title="Tools not appearing">
50+
- Check your Cursor MCP server logs
51+
- Verify Container Use tools are enabled in settings
52+
</Accordion>
53+
</AccordionGroup>
54+
55+
## Next Steps
56+
57+
<CardGroup cols={2}>
58+
<Card title="Back to Quickstart" icon="rocket" href="/quickstart">
59+
Return to the quickstart guide to create your first environment
60+
</Card>
61+
<Card
62+
title="Join Community"
63+
icon="discord"
64+
href="https://discord.gg/YXbtwRQv"
65+
>
66+
Get help and share experiences in #container-use
67+
</Card>
68+
</CardGroup>

‎docs/docs.json‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,12 @@
2929
{
3030
"group": "Integrations",
3131
"pages": [
32-
"agent-integrations"
32+
"claude-code",
33+
"cursor",
34+
"amazon-q",
35+
"vscode",
36+
"zed",
37+
"other-agents"
3338
]
3439
}
3540
]

0 commit comments

Comments
 (0)