Chuyển đến nội dung

Tài liệu · Bắt đầu nhanh

Bắt đầu với Project Orchestrator

Hai cách bắt đầu: cài ứng dụng máy tính, hoặc thiết lập máy chủ và kết nối Claude Code từ dòng lệnh. Điều kiện cần được giải thích rõ, từng bước một.

Chọn hướng đi của bạn

Tôi chỉ muốn dùng ứng dụng

Cài ứng dụng máy tính. Một trình hướng dẫn thiết lập sẽ dẫn bạn đi, nên bạn không phải gõ lệnh.

Bạn cần Docker Desktop và Claude Code. AI không đi kèm: Claude Code dùng tài khoản Claude của riêng bạn.

  1. Cài Docker Desktop. Ứng dụng có thể giúp bạn việc này.
  2. Tải ứng dụng cho hệ điều hành của bạn và mở nó.
  3. Làm theo trình hướng dẫn thiết lập. Nó kiểm tra Docker, có thể cài Claude Code, và khởi động các dịch vụ. Lần đầu mất vài phút.

Tôi là nhà phát triển

Cài máy chủ từ dòng lệnh và kết nối công cụ của riêng bạn, như Claude Code, qua MCP. Các bước ở bên dưới.

Các bước cho nhà phát triển: dòng lệnh

Trước khi bắt đầu

Docker
Docker 20.10+ với Compose 2.0+, để chạy Neo4j và Meilisearch
Một ứng dụng khách MCP
Claude Code, Cursor hoặc một agent OpenAI
Một dự án
Một kho mã, bằng một trong 17 ngôn ngữ được hỗ trợ
  1. 1.Cài trình điều phối

    Homebrew cài orchestrator (máy chủ), orch (một công cụ dòng lệnh nhỏ) và mcp_server (cầu nối mà công cụ của bạn khởi động). Trên Windows, hoặc nếu bạn thích một ứng dụng, hãy dùng ứng dụng máy tính ở phần tải về.

    Terminal

    brew install this-rs/tap/project-orchestrator# or, without Homebrewcurl -fsSL https://raw.githubusercontent.com/this-rs/project-orchestrator/main/install.sh | sh
  2. 2.Khởi động Neo4j và Meilisearch

    Bộ nhớ dự án nằm trong Neo4j và tìm kiếm chạy trên Meilisearch. Kho mã có sẵn một tệp compose khởi động cả hai. Ứng dụng máy tính làm việc này giúp bạn.

    Terminal

    git clone https://github.com/this-rs/project-orchestrator.gitcd project-orchestratordocker compose up -d neo4j meilisearch
  3. 3.Chạy máy chủ

    Máy chủ lắng nghe ở cổng 8080 theo mặc định và cũng phục vụ giao diện web. Mở http://localhost:8080 để kiểm tra nó đang chạy.

    Terminal

    orchestrator serve
  4. 4.Kết nối Claude Code qua MCP

    Một lệnh tìm Claude Code và thêm máy chủ MCP project-orchestrator ở chế độ stdio, với các công cụ đã được phê duyệt trước. Một ứng dụng khách MCP khác có thể khởi động mcp_server theo cách tương tự, với PO_SERVER_URL trỏ đến máy chủ của bạn.

    Terminal

    orchestrator setup-claude
  5. 5.Đồng bộ một dự án và chạy một kế hoạch

    Đăng ký kho mã của bạn và để PO đọc nó. Sau đó nhờ trợ lý của bạn lập một kế hoạch. Nó gọi các công cụ MCP, và bạn theo dõi các tác vụ và bước trong giao diện web.

    Terminal

    orchestrator sync --path .# then, in Claude Code:> Create a plan to add rate limiting to the public API,> split it into tasks with dependencies, and run it.