# Kết nối AI agent của bạn

Kết nối agent trên máy này, agent đám mây hoặc cầu nối lệnh nâng cao bằng đúng địa chỉ và một khoá riêng cho từng agent.

Source: https://muse4ai.lovable.app/vi/docs/connect-overview · Cập nhật 2026-11-02

## Trước khi bắt đầu

- Giữ app mở trên máy Windows và đăng nhập Muse.
- Xác định agent chạy trên máy này hay trên đám mây.

## 1. Bật kết nối và tạo khoá

Mở Cài đặt › API & agent. Bật API cho agent rồi tạo khoá đặt tên theo agent này. Chép khoá trước khi đóng hộp thoại.

## 2. Với agent trên máy này

Thêm máy chủ MCP qua HTTP bằng http://127.0.0.1:47821/mcp và khoá của bạn. Nếu đã đổi cổng, dùng địa chỉ hiện tại trong app. Xem [Claude Code](https://muse4ai.lovable.app/vi/agents/claude-code), [Cursor](https://muse4ai.lovable.app/vi/agents/cursor) hoặc [Codex](https://muse4ai.lovable.app/vi/agents/codex).

```text
MCP URL: http://127.0.0.1:47821/mcp
Authorization: Bearer msk_YOUR_KEY
```

## 3. Với agent đám mây

Agent đám mây không gọi được địa chỉ nội bộ của máy này. Thiết lập [truy cập từ xa](https://muse4ai.lovable.app/vi/docs/remote-access), rồi dùng địa chỉ MCP công khai cùng khoá. Xem [Claude](https://muse4ai.lovable.app/vi/agents/claude) hoặc [Lovable](https://muse4ai.lovable.app/vi/agents/lovable).

## 4. Với app chỉ nhận lệnh cục bộ

Cầu nối nâng cao chạy một lệnh cục bộ rồi chuyển yêu cầu tới máy chủ MCP qua HTTP. Dùng cấu hình trong bài hướng dẫn của agent, không tự đoán lệnh. Xem [mọi hướng dẫn agent](https://muse4ai.lovable.app/vi/agents). ChatGPT hiện chưa được hỗ trợ vì còn cần hỗ trợ đăng nhập OAuth.

## 5. Kiểm tra trước khi tạo nội dung

Nhờ agent gọi muse_status trước. Xác nhận agent đọc được trạng thái app rồi mới yêu cầu tạo ảnh hoặc video.

## Kiểm tra thành công

Agent đọc được trạng thái app bằng khoá riêng và đúng địa chỉ nội bộ hoặc công khai.

## Nếu không chạy

### Vì sao URL nội bộ không dùng được trong app đám mây?

Địa chỉ nội bộ trỏ tới máy đang gửi yêu cầu. Với agent đám mây, hãy dùng địa chỉ công khai từ phần truy cập từ xa.

### Vì sao agent báo không được cấp quyền?

Kiểm tra khoá còn hiệu lực và được gửi trong header Authorization kiểu Bearer. Địa chỉ công khai không thay thế khoá.