🚀 Getting Started with Archestra

Welcome to your journey into MCP-based AI agent development. This guide will take you from zero to building your first intelligent agent.

🎯 What is Archestra?

Archestra is an AI agent orchestration platform that enables developers to build, deploy, and manage intelligent agents that can interact with external systems through the Model Context Protocol (MCP).

💡 Think of it this way: If AI is the brain, and MCP is the nervous system, Archestra is the body that coordinates everything to take action.

With Archestra, you can:

Create AI agents that interact with real-world tools
Connect multiple MCP servers to a single agent
Orchestrate complex multi-step workflows
Monitor and debug agent behavior in real-time
Scale from prototype to production seamlessly

🔌 What is MCP?

MCP (Model Context Protocol) is an open standard that enables AI models to securely interact with external data sources and tools.

The MCP Analogy

Think of MCP like USB for AI:

USB = Universal standard for connecting devices
MCP = Universal standard for connecting AI to tools

Just like USB lets you plug any device into any computer, MCP lets you connect any tool to any AI agent.

Key MCP Concepts

🛠️ MCP Server

Exposes tools and resources that agents can use (like a GitHub API, database, or custom function)

🤖 MCP Client

The AI agent that consumes MCP servers and invokes tools

🔧 Tools

Specific functions exposed by an MCP server (e.g., "create_issue", "send_email")

🌉 Gateway

Routes tool calls from agents to the correct MCP server

💎 Why MCP Matters

Before MCP, every AI integration was custom-built. With MCP, you get:

Reusability

Build a tool once, use it with any MCP-compatible agent

Composability

Combine multiple tools to create powerful workflows

Security

Controlled, sandboxed execution of AI tool calls

Standardization

Industry-standard protocol means less reinventing the wheel

⚙️ How Agent Orchestration Works

Here's the flow when an AI agent uses a tool through Archestra:

1. Agent

"I need to create a GitHub issue"

↓

2. Gateway

Routes to GitHub MCP server

↓

3. MCP Server

Calls GitHub API

↓

4. Tool

Creates the issue

↓

5. Response

Returns result to agent

📦 Installation

Let's get Archestra installed on your machine.

⚠️ Prerequisites: Make sure you have Node.js 18+ and npm installed.

Step 1: Install Archestra CLI

npm install -g @archestra/cli

Step 2: Verify Installation

archestra --version

Step 3: Initialize a New Project

archestra init my-first-agent
cd my-first-agent

✅ You're all set! Archestra is now installed and ready to use.

🎯 Your First Steps

Now that you have Archestra installed, here's what to do next:

Ready to Dive Deeper? 🚀

Continue your learning journey with our comprehensive MCP basics guide

Learn MCP Basics →