Gladly MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.6.3更新於 Nov 7, 2026

Find customers, read conversations, items and tasks; add internal notes in Gladly.

發布方自己的服務：Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行溝通與協作商業與電商

服務詳細資訊

識別碼: io.usefulapi/gladly
傳輸: Streamable HTTP
執行環境: Web executable
信任: Verified
發布於: Oct 31, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此服務的命名空間屬於 usefulapi.io，且該網域同時執行其端點。這可以確認發布者，但並不代表該服務的工具是安全的。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Fgladly.svg)](https://sourceweft.com/mcp/io.usefulapi%2Fgladly?utm_source=readme&utm_medium=badge)

概覽

AI 產生的概覽

託管的 Gladly 客服系統 MCP 伺服器：查詢客戶、對話、時間軸與任務，並可新增內部備註。

可以做什麼: 依電子郵件、電話或外部 ID 尋找客戶檔案並讀取詳細資料
列出客戶的對話與任務，讀取單一對話、時間軸項目和任務
列出組織、客服人員、收件匣、主題與受眾等基礎資料
為對話新增內部備註（唯一的寫入工具）
查看用量、提出功能請求、升級或取消付費方案
適用情境: 適合客服與客戶成功團隊讓助理在不切換工具的情況下，從 Gladly 取得客戶歷史、對話時間軸與未結任務，或留下內部備註。
執行需求: 透過 streamable HTTP 連線的遠端端點，無需本機安裝。只需填入伺服器網址並以 OAuth 登入。首次連線時需提供 Gladly 組織、客服電子郵件與 Gladly API 權杖，伺服器會依使用者儲存。免費方案每月 50 次工具呼叫。

安裝前請注意

伺服器會保存你的 Gladly 組織、客服電子郵件與 API 權杖，可讀取客戶個人資料（姓名、電子郵件、電話、地址）與對話內容。gladly_add_conversation_note 會寫入 Gladly，每次呼叫都會新增一則備註，重複呼叫不會去重。付費方案透過 Stripe 結帳連結收費，取消後當期不退款。

安裝

在 SourceWeft 中

開啟儀表板中的 Gladly MCP by usefulapi，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fgladly/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "gladly-by-usefulapi": {
      "type": "http",
      "url": "https://gladly.usefulapi.io/mcp"
    }
  }
}

README

Gladly MCP by usefulapi

Use your Gladly account from Claude, Cursor, or any MCP client. Find customers, read conversations, items and tasks, and add internal notes. Hosted, no local install: connect with your own credentials.

Live endpoint: https://gladly.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://gladly.usefulapi.io/mcp.
Claude Code: claude mcp add --transport http gladly https://gladly.usefulapi.io/mcp, then run /mcp to log in.
VS Code: Add to VS Code.
Cursor and other clients: add the URL as a remote MCP server:

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Gladly credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/gladly/

On first connect you provide your Gladly organization, an agent email and an API token (Gladly → Settings → API). The server validates them and stores them per user. No keys go in config files.

Tools

Tool	Type	What it does
`gladly_get_organization`	read	Get the organization
`gladly_list_agents`	read	List agents
`gladly_get_agent`	read	Get an agent
`gladly_list_inboxes`	read	List inboxes
`gladly_get_inbox`	read	Get an inbox
`gladly_list_topics`	read	List topics
`gladly_list_audiences`	read	List audiences
`gladly_find_customers`	read	Find customers
`gladly_get_customer`	read	Get a customer
`gladly_list_customer_conversations`	read	List conversations of a customer
`gladly_get_conversation`	read	Get a conversation
`gladly_list_conversation_items`	read	List the timeline of a conversation
`gladly_get_conversation_item`	read	Get a conversation item
`gladly_list_customer_tasks`	read	List tasks of a customer
`gladly_get_task`	read	Get a task
`gladly_add_conversation_note`	write	Add an internal note to a conversation
`gladly_usage_status`	meta	Usage status (free-tier meter)
`gladly_request_feature`	meta	Request a missing feature
`gladly_upgrade`	meta	Upgrade to Pro or Pro+
`gladly_cancel_subscription`	meta	Cancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with gladly_upgrade (it returns a Stripe Checkout link). Cancel any time with gladly_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running gladly_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

來源：servers/gladly/README.md，提交 4046075

工具

gladly_get_organization

Get the organization

Get metadata about the Gladly organization: id, name, login domain, time zone, URL. Gladly API: GET /api/v1/organization.

無需輸入參數。

gladly_list_agents

List agents

List the agents (support users) with id, name and email address. Gladly API: GET /api/v1/agents.

無需輸入參數。

gladly_get_agent

Get an agent

Get one agent profile by id. Gladly API: GET /api/v1/agents/{agentId}.

輸入參數agent_id必填

gladly_list_inboxes

List inboxes

List the inboxes with id, name and disabled state. Gladly API: GET /api/v1/inboxes.

無需輸入參數。

gladly_get_inbox

Get an inbox

Get the metadata of one inbox by id. Gladly API: GET /api/v1/inboxes/{inboxId}.

輸入參數inbox_id必填

gladly_list_topics

List topics

List the conversation topics (id, name, parentId, disabled). Use it to turn the topicIds of a conversation into names. Gladly API: GET /api/v1/topics.

無需輸入參數。

gladly_list_audiences

List audiences

List the audiences used to target answers (id, name). Gladly API: GET /api/v1/audiences.

無需輸入參數。

gladly_find_customers

Find customers

Find customer profiles by EXACTLY ONE identifier: email, phone number (E.164, for example +16505551987) or externalCustomerId. Returns at most 50 profiles, newest update first. Gladly API: GET /api/v1/customer-profiles.

輸入參數emailphone_numberexternal_customer_id

gladly_get_customer

Get a customer

Get one customer profile by id: name, emails, phones, address, custom attributes. Gladly API: GET /api/v1/customer-profiles/{customerId}.

輸入參數customer_id必填

gladly_list_customer_conversations

List conversations of a customer

List the conversations of one customer, oldest first (at most 100; the reply says if it was cut). Each has topics, status and assignee. Gladly API: GET /api/v1/customers/{customerId}/conversations.

輸入參數customer_id必填

gladly_get_conversation

Get a conversation

Get the metadata of one conversation: assignee, inbox, topics, custom attributes, status. A merged conversation returns the surviving one. Gladly API: GET /api/v1/conversations/{conversationId}.

輸入參數conversation_id必填

gladly_list_conversation_items

List the timeline of a conversation

List the timeline items of a conversation (messages, emails, calls, notes), oldest first, at most 1000. Gladly API: GET /api/v1/conversations/{conversationId}/items.

輸入參數session_idconversation_id必填

gladly_get_conversation_item

Get a conversation item

Get one conversation item (message, email, note, call) by id. Gladly API: GET /api/v1/conversation-items/{itemId}.

輸入參數item_id必填

gladly_list_customer_tasks

List tasks of a customer

List the tasks of one customer, newest first (at most 2000), optionally only OPEN or CLOSED. Gladly API: GET /api/v1/customers/{customerId}/tasks.

輸入參數statuscustomer_id必填

gladly_get_task

Get a task

Get one task by id: body, assignee, due date, status, topics. Gladly API: GET /api/v1/tasks/{taskId}.

輸入參數task_id必填

gladly_add_conversation_note

Add an internal note to a conversation

WRITE: add an internal note to a conversation. The note is for agents only; the customer does not see it. Each call adds a NEW note, so do not repeat a call that succeeded. Gladly API: POST /api/v1/conversations/{conversationId}/notes.

輸入參數body必填conversation_id必填