Glen

npx add-mcp 'https://mcp.tryglen.com/mcp'

Một endpoint cho bộ nhớ tác nhân của nhóm bạn, từ mọi MCP client.

Máy chủ MCP từ xa của Glen cung cấp cho client bộ nhớ, kỹ năng và tài liệu đã lưu của tổ chức dưới dạng 22 công cụ. Trang này trình bày endpoint, cả hai cách đăng nhập, đầu vào và đầu ra của từng công cụ, các gợi ý giúp client quyết định nên hỏi về điều gì và các giới hạn.

URL máy chủ	https://mcp.tryglen.com/mcp
Giao thức truyền tải	Streamable HTTP (POST, GET và DELETE trên /mcp)
Đăng nhập	OAuth 2.1 với đăng ký client động hoặc khóa API cá nhân
Công cụ	22, mỗi công cụ có tiêu đề và gợi ý về hành vi
Giới hạn thời gian yêu cầu	60 giây
Giới hạn kích thước yêu cầu	4.5 MB mỗi yêu cầu

Endpoint

https://mcp.tryglen.com/mcp

Kết nối chính xác tới https://mcp.tryglen.com/mcp. Token OAuth được cấp với URL đó làm đối tượng nhận, và MCP client sẽ từ chối máy chủ có metadata chỉ định URL khác. https://app.tryglen.com/mcp chuyển hướng vĩnh viễn đến đó, còn mọi đường dẫn khác trên mcp.tryglen.com, ngoại trừ các tài liệu khám phá OAuth, đều chuyển hướng đến ứng dụng Glen.

Máy chủ sử dụng Streamable HTTP: client gửi POST các thông điệp JSON-RPC đến /mcp, có thể mở luồng GET để nhận thông điệp từ máy chủ và gửi DELETE để kết thúc phiên.

Đăng nhập

Mỗi yêu cầu được xác thực theo một trong hai cách, và cả hai đều quy về cùng một điều: một người trong một tổ chức.

OAuth, dành cho ứng dụng trò chuyện và hầu hết MCP client

1. 01 Client gọi https://mcp.tryglen.com/mcp mà không có token và nhận 401 Unauthorized cùng với WWW-Authenticate: Bearer resource_metadata="https://mcp.tryglen.com/.well-known/oauth-protected-resource/mcp" và các phạm vi openid profile email read:organization offline_access.
2. 02 Metadata của tài nguyên được bảo vệ chỉ định máy chủ ủy quyền, https://app.tryglen.com/api/auth, có metadata tại /.well-known/oauth-authorization-server.
3. 03 Client tự đăng ký thông qua đăng ký client động. Không cần đăng ký trước hay client secret; các URI chuyển hướng loopback (http://127.0.0.1) được chấp nhận cho client trên máy tính và CLI.
4. 04 Người dùng thực hiện quy trình cấp mã ủy quyền với PKCE: trang đăng nhập của Glen, sau đó là bộ chọn tổ chức nếu họ thuộc nhiều tổ chức, rồi đến trang chấp thuận.
5. 05 Client nhận access token đã ký (issuer https://app.tryglen.com/api/auth, audience https://mcp.tryglen.com/mcp) và, vì đã được cấp offline_access, một refresh token. Token chứa tổ chức đã chọn trong claim https://app.tryglen.com/org_id.

Token luôn gắn với tổ chức được chọn khi đăng nhập. Để dùng tổ chức khác, hãy ngắt kết nối rồi kết nối lại; glen_list_orgs cho biết kết nối đang dùng tổ chức nào.

API key, dành cho script và glen CLI

Tạo khóa trong mục Settings → API keys trên bảng điều khiển Glen. Khóa mang tính cá nhân: khóa thuộc về bạn, không thuộc về tổ chức, và dùng được trong mọi tổ chức mà bạn tham gia. Mỗi yêu cầu chỉ định tổ chức trong một header:

POST /mcp HTTP/1.1
Host: mcp.tryglen.com
x-api-key: <your key>
x-glen-org-id: <organization id>

Nếu không có x-glen-org-id, máy chủ trả lời 401 với no active organization: run `glen org switch`. Add x-glen-incognito: true để thực hiện yêu cầu không ghi lại. Khi yêu cầu có cả API key và bearer token, khóa là thông tin được kiểm tra.

Kiểm tra trong mỗi yêu cầu

Trước khi chạy bất kỳ công cụ nào, máy chủ xác nhận người dùng vẫn tồn tại và vẫn là thành viên của tổ chức. Việc xóa ai đó khỏi tổ chức hoặc xóa tài khoản của họ sẽ vô hiệu hóa token và khóa của họ ngay trong yêu cầu tiếp theo, không cần chờ hết hạn. Lỗi trả về 401 cùng header WWW-Authenticate tương tự, để client có thể bắt đầu lại quy trình đăng nhập.

Công cụ

Mỗi công cụ nhận một đối tượng JSON và trả về kết quả dưới dạng văn bản JSON. Các công cụ đọc hoạt động với tư cách bạn: chúng chỉ trả về những gì bạn vốn đã có thể xem trên bảng điều khiển Glen, trong tổ chức đang kết nối. Các công cụ ghi chỉ thay đổi tài khoản của bạn, nội dung do bạn viết hoặc bộ nhớ của tổ chức thay mặt bạn.

Tìm kiếm và truy hồi

Đặt câu hỏi về bộ nhớ của tổ chức hoặc hỏi lý do một đoạn mã cụ thể tồn tại.

Kỹ năng

Kỹ năng là các hướng dẫn Markdown, có thể kèm tệp, được nhóm lưu một lần để bất kỳ tác nhân nào cũng có thể chạy. Chỉ tác giả xem được cho đến khi chia sẻ.

Dùng kỹ năng

Chỉ đọc

glen_skill_use

Lấy hướng dẫn của kỹ năng theo slug để tác nhân có thể làm theo.

slug

(string)

Slug chính xác từ glen_skill_search.

conversationId

(string, optional)

ID của phiên gọi, dùng để tính số lượt sử dụng.

cached

(object, optional)

Các kỹ năng client đã có (slug ánh xạ tới thời điểm cập nhật gần nhất), để không gửi lại những kỹ năng đã được tham chiếu.

Trả về: Hướng dẫn Markdown của kỹ năng dưới dạng nội dung, các tệp của kỹ năng và những kỹ năng được tham chiếu mà client chưa có.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Lưu kỹ năng

GhiCần có kế hoạch kèm tìm kiếm

glen_skill_create

Lưu kỹ năng Markdown vào thư viện của bạn; chỉ riêng bạn xem được cho đến khi chia sẻ.

name

(string, tối đa 120)

Tên kỹ năng; slug được tạo từ tên này.

description

(string, tối đa 500)

Một dòng cho biết khi nào nên dùng kỹ năng.

content

(string, tối đa 1 MB)

Nội dung của SKILL.md.

files

(array, tối đa 100, optional)

Script, tài liệu tham khảo hoặc tài nguyên, mỗi mục có đường dẫn và loại nội dung.

dependencies

(array, optional)

ID dependency hiện có hoặc dependency mới (name, description, sourceUrl, kind).

org

(boolean, optional)

true chia sẻ với toàn bộ tổ chức.

update

(boolean, optional)

true thay thế kỹ năng cùng tên của bạn.

Trả về: slug, thông tin cho biết kỹ năng hiện có đã được cập nhật hay chưa và kỹ năng có được chia sẻ với tổ chức hay không.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Xóa kỹ năng

Xóa

glen_skill_delete

Xóa vĩnh viễn kỹ năng do bạn viết. Chỉ thực hiện khi bạn yêu cầu.

slug

(string)

Kỹ năng do bạn viết. Kỹ năng sẽ bị xóa đối với tất cả những người được chia sẻ.

Trả về: Xác nhận kỹ năng đã bị xóa.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Tài liệu

Tài liệu là các tài liệu đã lưu (Markdown hoặc HTML và CSS, không có JavaScript). Chỉ tác giả xem được cho đến khi chia sẻ.

Lấy tài liệu

Chỉ đọc

glen_artifact_get

Lấy tài liệu đã lưu theo slug.

slug

(string)

Slug chính xác.

Trả về: slug, tiêu đề, định dạng, toàn bộ nội dung, bản tóm tắt và tác giả.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Lưu tài liệu

Ghi

glen_artifact_create

Lưu tài liệu Markdown hoặc HTML vào thư viện của bạn; chỉ riêng bạn xem được cho đến khi chia sẻ.

title

(string, tối đa 200)

Tiêu đề tài liệu; slug được tạo từ tiêu đề này.

format

(markdown hoặc html)

HTML có thể chứa CSS nhưng không có JavaScript.

content

(string, tối đa 200,000 ký tự)

Tài liệu.

shareWithOrg

(boolean, optional)

true chia sẻ với toàn bộ tổ chức.

update

(boolean, optional)

true thay thế tài liệu cùng tiêu đề của bạn.

Trả về: slug, thông tin cho biết tài liệu hiện có đã được cập nhật hay chưa và tài liệu có được chia sẻ với tổ chức hay không.

giới hạn tốc độ: 30 lệnh gọi mỗi phút cho mỗi người dùng

Xóa tài liệu

Xóa

glen_artifact_delete

Xóa vĩnh viễn tài liệu do bạn viết. Chỉ thực hiện khi bạn yêu cầu.

slug

(string)

Tài liệu do bạn viết.

Trả về: Xác nhận tài liệu đã bị xóa.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Chỉnh sửa và nhập bộ nhớ

Giữ cho nội dung truy hồi chính xác bằng cách quên những ký ức sai, khôi phục chúng hoặc thêm các cuộc trò chuyện trước đây với tác nhân.

Nhập cuộc trò chuyện trước đây

Ghi

glen_import

Thêm cuộc trò chuyện trước đây với tác nhân vào bộ nhớ nhóm khi bạn yêu cầu.

conversationId

(string)

import:<session id>, giống nhau cho mọi lượt trong một phiên.

idempotencyKey

(string)

<conversationId>:<turn index>, để khi chạy lại, các lượt đã nhập sẽ được bỏ qua.

messages

(array (1 to 100))

Tin nhắn của người dùng và câu trả lời trong lượt, mỗi tin nhắn có role, content và occurredAt ban đầu.

additionalContext

(object, optional)

Tên tác nhân và workspace (cwd, branch, repoName, remoteUrl).

Trả về: Thông tin cho biết lượt đã được lưu hay đã được nhập trước đó, cùng số lượng tin nhắn được thêm.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Quên bằng chứng

Ghi

glen_forget

Ngăn không cho truy hồi lại ký ức sai hoặc lỗi thời. Có thể hoàn tác bằng glen_restore.

references

(string[] (1 to 50))

Các tham chiếu observation:<id> hoặc message:<id> từ nguồn tìm kiếm.

Trả về: Những tham chiếu đã bị quên, những tham chiếu đã bị quên từ trước và số lượng ký ức bị ẩn vì mọi tin nhắn làm căn cứ cho chúng đều đã bị quên.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Khôi phục bằng chứng đã quên

Ghi

glen_restore

Khôi phục ký ức đã bị quên.

references

(string[] (1 to 50))

Các tham chiếu đã bị quên trước đó.

Trả về: Những tham chiếu đã được khôi phục, những tham chiếu không cần thay đổi và số lượng ký ức ẩn được khôi phục cùng chúng.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Cài đặt và tổ chức

Đọc và thay đổi cài đặt Glen của bạn, xem các tổ chức bạn tham gia, mời mọi người và gửi phản hồi.

Liệt kê tổ chức

Chỉ đọc

glen_list_orgs

Liệt kê các tổ chức bạn tham gia và đánh dấu tổ chức mà kết nối này đang dùng.

Không có đầu vào.

Trả về: Các tổ chức của bạn, trong đó tổ chức mà kết nối này đang dùng có active: true.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Xem cài đặt glen

Chỉ đọc

glen_status

Hiển thị chế độ ghi nhận của bạn và trạng thái bật/tắt gợi ý kỹ năng.

Không có đầu vào.

Trả về: Chế độ Glen của bạn (on, off, incognito hoặc silent) và trạng thái bật/tắt gợi ý kỹ năng.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Mời đồng đội

GhiChỉ dành cho chủ sở hữu và quản trị viên

glen_invite

Mời mọi người vào tổ chức của bạn qua email. Chỉ chủ sở hữu và quản trị viên mới được dùng.

emails

(string[] (1 to 50))

Những người cần mời.

role

(member hoặc admin)

Mặc định là member. Công cụ không thể tạo chủ sở hữu.

Trả về: invited, alreadyMember và failed (mỗi mục kèm lý do), cùng ghi chú khi phát sinh phí cho chỗ mới.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Đặt chế độ glen

Ghi

glen_set_recording

Chuyển tài khoản của bạn giữa các chế độ on, off, incognito và silent.

mode

(on, off, incognito hoặc silent)

Áp dụng cho tài khoản của bạn trên mọi máy và tác nhân.

Trả về: Chế độ đã lưu và thời điểm thay đổi.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Đặt gợi ý kỹ năng

Ghi

glen_set_suggestions

Bật hoặc tắt các đề xuất của Glen về việc lưu hoặc dùng lại kỹ năng.

skillCreation

(boolean, optional)

Đề xuất lưu công việc đã hoàn thành thành kỹ năng mới.

skillUse

(boolean, optional)

Đề xuất các kỹ năng hiện có phù hợp với tác vụ.

Trả về: Các cài đặt đã lưu.

giới hạn tốc độ: 600 lệnh gọi mỗi phút cho mỗi người dùng

Gợi ý về hành vi

Mỗi công cụ khai báo bốn gợi ý hành vi MCP và một tiêu đề. Client đọc các thông tin này để quyết định hiển thị gì và cần hỏi về điều gì: client có thể chạy công cụ chỉ đọc mà không cần hỏi, đồng thời hỏi trước khi chạy bất kỳ công cụ nào ghi dữ liệu; thư mục connector của Anthropic cũng phân nhóm công cụ thành chỉ đọc hoặc ghi dựa trên các thông tin này.

readOnlyHint

true khi công cụ không bao giờ thay đổi bất cứ điều gì. Có chín công cụ: tìm kiếm, tìm kiếm mã, tìm kiếm và dùng kỹ năng, tìm kiếm dependency, tìm kiếm và lấy tài liệu, liệt kê tổ chức và trạng thái.

destructiveHint

true khi một lệnh gọi có thể ghi đè, xóa hoặc ẩn nội dung nào đó, hoặc thay đổi người có thể xem nội dung đó: lưu kỹ năng hoặc tài liệu (update: true thay thế nội dung của bạn), chia sẻ, xóa và quên.

idempotentHint

true khi gọi lại với cùng đối số không tạo thêm tác động nào. False đối với việc lưu kỹ năng hoặc tài liệu, mời mọi người và gửi phản hồi.

openWorldHint

true trên mọi công cụ ghi, vì tác động vượt ra ngoài cuộc trò chuyện: đồng đội có thể thấy kỹ năng được chia sẻ và ký ức được truy hồi, lời mời sẽ gửi email và cài đặt áp dụng trên mọi máy. False trên mọi công cụ chỉ đọc.

Tool	readOnly	destructive	idempotent	openWorld
glen_search	true	false	true	false
glen_code_search	true	false	true	false
glen_skill_search	true	false	true	false
glen_skill_use	true	false	true	false
glen_artifact_search	true	false	true	false
glen_artifact_get	true	false	true	false
glen_dependency_search	true	false	true	false
glen_list_orgs	true	false	true	false
glen_status	true	false	true	false
glen_skill_create	false	true	false	true
glen_skill_share	false	true	true	true
glen_artifact_create	false	true	false	true
glen_artifact_share	false	true	true	true
glen_import	false	false	true	true
glen_forget	false	true	true	true
glen_restore	false	false	true	true
glen_invite	false	false	false	true
glen_set_recording	false	false	true	true
glen_set_suggestions	false	false	true	true
glen_feedback	false	false	false	true
glen_skill_delete	false	true	true	true
glen_artifact_delete	false	true	true	true

Giới hạn và lỗi

Giới hạn tốc độ

Giới hạn được tính theo từng người dùng và từng công cụ. Khi vượt quá giới hạn, công cụ sẽ trả về lỗi như Too many requests. Try again in 20s.

• 60 lần gọi mỗi phút: glen_search, glen_code_search, glen_skill_search, glen_artifact_search.
• 30 lần gọi mỗi phút: glen_artifact_create, công cụ này ghi bản tóm tắt của từng tài liệu.
• 10 lần gọi mỗi giờ: glen_feedback.
• 600 lần gọi mỗi phút: mọi công cụ khác.

Giới hạn kích thước

• Nội dung yêu cầu có thể tối đa 4.5 MB và một yêu cầu có thể chạy tối đa 60 giây.
• Nội dung của một kỹ năng có thể tối đa 1 MB, với tối đa 100 tệp.
• Một hiện vật có thể dài tối đa 200,000 ký tự.
• glen_import nhận tối đa 100 tin nhắn mỗi lần gọi, mỗi tin nhắn tối đa 100,000 ký tự.

Gói dịch vụ

Mọi công cụ đều hoạt động với gói Free, lưu trữ tối đa 15,000 ký ức. Không gian làm việc không có gói dịch vụ hoặc có khoản thanh toán gần nhất không thành công vẫn có thể đăng nhập và sử dụng các công cụ không tìm kiếm, nhưng các công cụ sau sẽ trả về lỗi:

glen_search, glen_code_search, glen_skill_search, glen_dependency_search, glen_skill_create, glen_artifact_search

Lỗi cho biết vấn đề là gì và ai có thể khắc phục, ví dụ This workspace has no plan. An owner can choose one in Billing. glen_import cũng bị từ chối theo cách tương tự khi tính năng ghi bị tạm dừng. Lỗi công cụ không bao giờ chứa liên kết hoặc lời mời mua bất cứ thứ gì.

Các lỗi khác

• 401 trong yêu cầu HTTP: không có thông tin xác thực, token hoặc khóa đã hết hạn hay không hợp lệ, hoặc người dùng không còn là thành viên. Ứng dụng khách sẽ đăng nhập lại.
• Lỗi công cụ kèm thông báo xác thực: dữ liệu đầu vào không khớp với lược đồ của công cụ. Thông báo nêu tên trường.
• Lỗi công cụ cho biết hành động không được phép: glen_invite từ người không phải chủ sở hữu hoặc quản trị viên, hoặc xóa kỹ năng hay tài liệu mà bạn không viết.
• Lỗi công cụ cho biết không tìm thấy nội dung: slug không tồn tại hoặc bạn không thể xem.

Kết nối ứng dụng khách

Claude và ChatGPT có các trang hướng dẫn từng bước riêng: Glen cho Claude và Glen cho ChatGPT. Mọi ứng dụng khách khác hỗ trợ máy chủ MCP từ xa với OAuth chỉ cần URL.

Claude Code

claude mcp add --transport http glen https://mcp.tryglen.com/mcp

Cursor và các ứng dụng khách đọc mcp.json

{
  "mcpServers": {
    "glen": {
      "url": "https://mcp.tryglen.com/mcp"
    }
  }
}

Ứng dụng khách sẽ mở trang đăng nhập của Glen trong lần kết nối đầu tiên. Với tác nhân lập trình, plugin glen thường phù hợp hơn: plugin ghi lại các phiên vào bộ nhớ nhóm và, nếu tác nhân cho phép, truy xuất lại trong mỗi lượt. Plugin kết nối với Glen thông qua CLI glen và các hook thay vì những công cụ này; xem Glen cho Cursor và Glen cho pi.