Kết nối các MCP client khác

Ngoài Claude và ChatGPT, mọi MCP client hỗ trợ máy chủ từ xa qua HTTP và đăng nhập OAuth đều dùng được – ví dụ IDE như Cursor, hoặc MCP Inspector để thử nghiệm. Bài này dành cho những ai tự thiết lập client như vậy hoặc xây dựng tích hợp riêng.

#Thông tin chính

URL máy chủ

https://dock.at-harbor.com/mcp

Transport

Streamable HTTP, không trạng thái. Mỗi yêu cầu là một POST với một thông điệp JSON-RPC (hoặc một batch), và phản hồi trả về dạng JSON. Không có session ID và không có luồng từ máy chủ.

Phiên bản giao thức

2025-11-25, 2025-06-18 và 2025-03-26

Phương thức

initialize, ping, tools/list và tools/call. Máy chủ không cung cấp resources hay prompts.

Đăng nhập

OAuth 2.1 với PKCE (S256). Không có token, máy chủ phản hồi 401 và trỏ đến metadata của nó trong header WWW-Authenticate.

#Thiết lập client

1. Trong client, thêm một máy chủ MCP từ xa (thường gọi là “Remote”, “HTTP” hoặc “Streamable HTTP”)
2. Nhập https://dock.at-harbor.com/mcp làm URL
3. Để trống client ID và secret – client tự đăng ký
4. Bắt đầu kết nối; trang đăng nhập mở trong trình duyệt, tiếp theo là trang chấp thuận của LinkHarbor
5. Chọn không gian làm việc và quyền rồi nhấp “Cho phép”

Tên của cài đặt khác nhau giữa các chương trình. Ví dụ trong MCP Inspector, bạn chọn transport “Streamable HTTP”.

#Chi tiết luồng OAuth

1. Client gọi máy chủ MCP không kèm token và nhận 401 với chỉ dẫn đến resource metadata
2. Client đọc metadata của authorization server (endpoint, phương thức được hỗ trợ, quyền)
3. Client tự đăng ký: qua Dynamic Client Registration hoặc bằng một client metadata document tại một URL https
4. Client mở trình duyệt với yêu cầu ủy quyền, kèm PKCE và resource=https://dock.at-harbor.com/mcp
5. Bạn đăng nhập và quyết định trên trang chấp thuận
6. Client đổi mã lấy access token và refresh token

Nếu client không yêu cầu quyền nào, mọi quyền sẽ được yêu cầu; bạn vẫn có thể thu hẹp chúng trên trang chấp thuận. Nếu một refresh token đã bị thay thế được dùng lại, LinkHarbor kết thúc toàn bộ kết nối vì lý do bảo mật.

#Quy tắc cho địa chỉ chuyển hướng

• Địa chỉ https
• http chỉ dành cho địa chỉ loopback trên chính máy tính của bạn (cho client máy tính và IDE)
• Scheme ứng dụng tùy chỉnh theo ký hiệu tên miền đảo ngược
• Tối đa 10 địa chỉ cho mỗi client, không có fragment

Nếu một ứng dụng gửi địa chỉ không được đăng ký cho nó, LinkHarbor sẽ dừng: “Ứng dụng đã gửi địa chỉ quay lại không được đăng ký cho nó. Yêu cầu đã bị dừng.”

#Địa chỉ discovery cho nhà phát triển

#Ứng dụng không xác định

Các ứng dụng có mọi địa chỉ chuyển hướng nằm trên claude.ai, claude.com, chatgpt.com hoặc openai.com được coi là quen thuộc. Các chương trình trên máy tính của chính bạn quay lại qua localhost – như Claude Code, Codex và IDE – hiển thị ghi chú “LinkHarbor không biết ứng dụng này. Ứng dụng đang chạy trên máy tính của chính bạn. Chỉ tiếp tục nếu bạn vừa tự khởi động nó.” trên trang chấp thuận, và ở phía dưới là “Sau khi chọn, bạn sẽ quay lại ứng dụng trên máy tính của mình.” Các ứng dụng web lạ khác hiển thị “LinkHarbor không biết ứng dụng này. Chỉ tiếp tục nếu chính bạn bắt đầu và bạn tin tưởng …”, trong đó chỗ … là địa chỉ của chúng. Cả hai ghi chú đều bình thường nếu bạn vừa tự thiết lập client. Logo chỉ xuất hiện nếu ứng dụng gửi kèm. Nếu bạn không tự bắt đầu việc đăng nhập, hãy nhấp “Từ chối”.