Ứng dụng khác
Kết nối Assistant Core MCP với MCP client chưa có hướng dẫn riêng, kể cả client chỉ hỗ trợ MCP local.
Ứng dụng AI không có trong các trang trước vẫn kết nối được nếu hỗ trợ remote MCP. Tìm trong tài liệu của ứng dụng mục như "remote MCP server", "custom connector" hoặc "HTTP MCP server", rồi dùng URL:
https://api.assistantcore.com/mcpHầu hết ứng dụng nhận cấu hình JSON dạng:
{
"mcpServers": {
"assistant-core": {
"url": "https://api.assistantcore.com/mcp"
}
}
}Tên key có thể khác (url, serverUrl, httpUrl). Nếu ứng dụng hỏi transport, chọn Streamable HTTP (hoặc HTTP), không chọn SSE. Nếu ứng dụng hỏi xác thực, chọn OAuth và để trống Client ID, Client Secret.
Ứng dụng chỉ hỗ trợ MCP local
Một số ứng dụng chỉ chạy MCP server local (stdio, khai báo bằng command). Dùng mcp-remote làm cầu nối; máy cần có Node.js:
{
"mcpServers": {
"assistant-core": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.assistantcore.com/mcp"]
}
}
}Lần chạy đầu tiên, mcp-remote mở trình duyệt để bạn đăng nhập Assistant Core, rồi lưu token trong ~/.mcp-auth.
Yêu cầu kỹ thuật
Dành cho người phát triển MCP client hoặc khi cần kiểm tra vì sao một ứng dụng không kết nối được:
| Mục | Giá trị |
|---|---|
| Transport | Streamable HTTP (không hỗ trợ SSE) |
| URL | https://api.assistantcore.com/mcp |
| Phát hiện xác thực | 401 kèm WWW-Authenticate trỏ tới /.well-known/oauth-protected-resource/mcp (RFC 9728) |
| Authorization server | /.well-known/oauth-authorization-server (RFC 8414) |
| Luồng | OAuth 2.1 Authorization Code + PKCE S256 |
| Đăng ký client | Client ID Metadata Document (client_id_metadata_document_supported), hoặc Dynamic Client Registration (/oauth/register) cho client cũ. Metadata document phải mô tả public client (token_endpoint_auth_method: none) |
| Redirect URI | HTTPS, http://localhost / 127.0.0.1, hoặc scheme riêng của native app. Không nhận fragment |
| Access token | Hiệu lực 1 giờ; refresh token xoay vòng, hết hạn sau 30 ngày không dùng |
Ứng dụng chỉ nhận API key cố định (không có OAuth) chưa dùng được, vì Assistant Core MCP không cấp API key.
Xử lý sự cố kết nối
| Hiện tượng | Cách xử lý |
|---|---|
| Không mở trình duyệt để đăng nhập | Tìm nút Connect, Authenticate hoặc lệnh đăng nhập trong mục MCP của ứng dụng. Một số ứng dụng chỉ mở khi gọi tool lần đầu |
| Đăng nhập xong nhưng ứng dụng vẫn báo lỗi xác thực | Dùng Clear authentication / Disconnect trong mục MCP của ứng dụng, rồi kết nối lại |
| Ứng dụng báo lỗi transport | Ứng dụng đang dùng SSE. Đổi sang Streamable HTTP, hoặc dùng mcp-remote |
| Kết nối được nhưng không thấy trợ lý | Lúc cấp quyền chưa chọn trợ lý đó. Ngắt kết nối rồi kết nối lại |
| Ứng dụng chạy trên server từ xa hoặc qua SSH | Luồng đăng nhập cần trình duyệt trên cùng máy với ứng dụng. Kết nối trên máy local |
Các lỗi khi gọi tool (FORBIDDEN, GRANT_SCOPE_REQUIRED…) xem ở Tổng quan.