Archestra Logo
Star us on GitHub ⭐

Quickstart

3 min read

Run it locally to try!

The fact that you're reading this means that you're willing to give it a try. First of all, thank you! We've prepared an all-in-one Docker image and hope it will make the first meeting with Archestra simple and pleasant ☺️

Linux / macOS:

docker pull archestra/platform:latest;
docker run -p 9000:9000 -p 3000:3000 \
   -e ARCHESTRA_QUICKSTART=true \
   -v /var/run/docker.sock:/var/run/docker.sock \
   -v archestra-postgres-data:/var/lib/postgresql/data \
   -v archestra-app-data:/app/data \
   archestra/platform;

Windows (PowerShell):

docker pull archestra/platform:latest;
docker run -p 9000:9000 -p 3000:3000 `
   -e ARCHESTRA_QUICKSTART=true `
   -v /var/run/docker.sock:/var/run/docker.sock `
   -v archestra-postgres-data:/var/lib/postgresql/data `
   -v archestra-app-data:/app/data `
   archestra/platform;

Once it's up, follow http://localhost:3000

Build Your First Agent Easy

  1. Go to MCP Registry, search for microsoft__playwright-mcp, install it.
  2. Gaze at Archestra running the MCP server in Kubernetes cluster! (If you want to make sure: kubectl get pods)
  3. Go to Agents and create "Archestra Docs Reader Agent" with this system prompt: You're using playwright to answer questions about Archestra based on https://archestra.ai/docs/
  4. While editing the agent, make sure to enable all microsoft__playwright-mcp tools for it.
  5. Go to Settings -> LLM API Keys and add your preferred provider. You can connect commercial providers like OpenAI, Anthropic, or Google Gemini. For a free option, use Cerebras or a local Ollama instance.
  6. Go to Chat, choose the "Archestra Docs Reader Agent" and ask "How could I deploy Archestra?"
    Archestra Chat UI calling the agent
  7. Enjoy Archestra navigating the website for you!

Connect to Your Agent via MCP Gateway Advanced

Archestra is not just a Chat UI, it's a very capable MCP Gateway. Let's connect our "Archestra Docs Reader Agent" to Claude Code to make sure we can trigger it as an MCP server!

  1. Go to MCP Gateways, create a new one.
  2. Make sure to set "Archestra Docs Reader Agent" as a sub-agent.
  3. Save changes and Copy MCP configuration.
  4. Add MCP Gateway to your Claude. Here is my archestra config (your auth key will be different!):
{
  "mcpServers": {
    "archestra": {
      "url": "http://localhost:9000/v1/mcp/e1b0272c-3839-4575-a49d-aabb864d638d",
      "headers": {
        "Authorization": "Bearer arch_119220a7bfc485d66b678d3e9fb2db36"
      }
    }
  }
}

I converted it to the command for claude:

claude mcp add archestra "http://localhost:9000/v1/mcp/e1b0272c-3839-4575-a49d-aabb864d638d" --transport http --header "Authorization: Bearer arch_119220a7bfc485d66b678d3e9fb2db36"

Now ask Claude:

Ask archestra to give you all the deployment options.

Feel the magic ✨

What's next?