MCP catalogue

1. 1

   取得金鑰 Get a key

   Ask the MCP admin for a key. The admin opens https://orbit-medical-systems.orbit-poc.com/mcp/admin and:

   1. opens the tab 權杖 (Tokens);
   2. in the card 內部閘道器權杖 (internal gateway key), types who it is for in 簽給誰;
   3. picks the end date (到期日), or 無到期 for no end;
   4. presses 產生權杖 (Generate). The key is shown once: copy it and hand it over privately. Keep it like a password: never in a group chat, an e-mail or a screenshot.

   

   

   You should see 應該看到： a long code that starts with hismcp_gk_, and the date it ends.

2. 2

   確認連線 Check you can reach the gateway

   Open https://orbit-medical-systems.orbit-poc.com/api/mcp/v1/systems in a browser. It needs no key.

   You should see 應該看到： text that starts with [{"scheme":: the list of addresses.

   If not 如果沒有： your network blocks the gateway. Ask for the VPN, or ask the MCP admin to allow your address.

3. 3

   選擇位址 Pick an address

   Each address is one group of tools. Pick the one you need; one client entry per address. staff-schedule, nhi-ops and comms are chat flows: they take a chat identity instead of a key (see the usage guide, section 3).

   MCP addresses

   Name	Purpose	Tools	Services	MCP address
   analytics 數據分析與 AI	Governed analytics and AI: FHIR exchange, data platform, BI reports, AI models.	44	ai-inference, bi-reporting, data-platform, fhir-exchange	https://orbit-medical-systems.orbit-poc.com/mcp/analytics/Copy 複製Copied 已複製Copy failed
   ancillary 醫療輔助（檢驗、影像、檢查）	Order fulfilment: laboratory, radiology and exam scheduling; microbiology and pathology reports and MDRO flags; sterile supply (CSSD) status (read only).	490	cssd, diagnostics, exam-scheduling, laboratory, micropath, radiology	https://orbit-medical-systems.orbit-poc.com/mcp/ancillary/Copy 複製Copied 已複製Copy failed
   audit	Read the audit trail: events, verification runs, a patient's access report, review-queue items and archive query results; start a chain verification; assign a review item to a reviewer.	10	audit	https://orbit-medical-systems.orbit-poc.com/mcp/audit/Copy 複製Copied 已複製Copy failed
   clinical 臨床診療	Run a visit and inpatient stay: workspace, orders, notes, CDSS, queue, nursing, ER, admissions, surgery, closed-loop safety.	389	adt, bff, cdss, closed-loop-safety, emergency, emr, nursing, orders, queue, surgery	https://orbit-medical-systems.orbit-poc.com/mcp/clinical/Copy 複製Copied 已複製Copy failed
   comms 客服通話	Call-centre staff: work the outbound call list, call patients, book callbacks, read call logs and contact records, search call transcripts, and keep meeting minutes and decisions.	35	comms, notification	https://orbit-medical-systems.orbit-poc.com/mcp/comms/Copy 複製Copied 已複製Copy failed
   finance 批價與健保申報	Price a visit, take payment and submit NHI claims.	134	billing, erpbridge, nhi-claims, payment	https://orbit-medical-systems.orbit-poc.com/mcp/finance/Copy 複製Copied 已複製Copy failed
   knowledge 規範與知識文件	Search and read controlled policy documents (SOP, NHI review notes, accreditation standards, regulations), cite them, add notes, and draft and submit new versions.	35	knowledge	https://orbit-medical-systems.orbit-poc.com/mcp/knowledge/Copy 複製Copied 已複製Copy failed
   laboratory 檢驗	Laboratory orders, tracking, results, microbiology, pathology, send-out and QC.	79	laboratory	https://orbit-medical-systems.orbit-poc.com/mcp/laboratory/Copy 複製Copied 已複製Copy failed
   leave-rulings 醫師請假與代診	Read doctor leave requests and the cover ruling of each affected clinic session.	3	org-config	https://orbit-medical-systems.orbit-poc.com/mcp/leave-rulings/Copy 複製Copied 已複製Copy failed
   microbiology 微生物檢驗	Read microbiology: the culture worklist, one case worksheet, and a patient's culture reports.	3	micropath	https://orbit-medical-systems.orbit-poc.com/mcp/microbiology/Copy 複製Copied 已複製Copy failed
   nhi-ops 健保卡作業	NHI card operations (read-only): card transactions, uploads, workstation health and active alerts; MediCloud lookups remain unavailable until a stronger identity check is decided.	6	nhi-card, org-config	https://orbit-medical-systems.orbit-poc.com/mcp/nhi-ops/Copy 複製Copied 已複製Copy failed
   notification 通知	Send notices to patients and staff (one or many recipients) and check delivery.	27	notification	https://orbit-medical-systems.orbit-poc.com/mcp/notification/Copy 複製Copied 已複製Copy failed
   office	Office email and official documents (公文): send email, dispatch a 公文, register, assign and close received documents, follow deadlines and receipts.	11	erpbridge	https://orbit-medical-systems.orbit-poc.com/mcp/office/Copy 複製Copied 已複製Copy failed
   pharmacy 藥局	Dispense and administer medications; manage stock.	172	inventory, pharmacy	https://orbit-medical-systems.orbit-poc.com/mcp/pharmacy/Copy 複製Copied 已複製Copy failed
   reference 共用主檔	Master data for staff: codes and dictionaries, orderables, fees and prices, the organization, beds, clinic sessions, parameters, staff, licences and privileges.	208	org-config, terminology	https://orbit-medical-systems.orbit-poc.com/mcp/reference/Copy 複製Copied 已複製Copy failed
   registry 病人與掛號	Find patients and manage encounters, registration, NHI-card visits and healthcare-certificate (HCA) signatures.	210	hca, nhi-card, patient-registry, registration	https://orbit-medical-systems.orbit-poc.com/mcp/registry/Copy 複製Copied 已複製Copy failed
   staff-schedule 醫師門診班表	Doctors: check your clinic sessions and file or withdraw leave by chat.	6	org-config	https://orbit-medical-systems.orbit-poc.com/mcp/staff-schedule/Copy 複製Copied 已複製Copy failed
   workforce 人力排班	Build and publish nursing/medical staff rosters, leave, overtime, nurse-to-patient ratios and the float pool.	116	workforce	https://orbit-medical-systems.orbit-poc.com/mcp/workforce/Copy 複製Copied 已複製Copy failed

4. 4

   連接你的工具 Connect your client

   Address for the commands belowanalytics 數據分析與 AI (44 tools)ancillary 醫療輔助（檢驗、影像、檢查） (490 tools)audit (10 tools)clinical 臨床診療 (389 tools)comms 客服通話 (35 tools), chat flowfinance 批價與健保申報 (134 tools)knowledge 規範與知識文件 (35 tools)laboratory 檢驗 (79 tools)leave-rulings 醫師請假與代診 (3 tools)microbiology 微生物檢驗 (3 tools)nhi-ops 健保卡作業 (6 tools), chat flownotification 通知 (27 tools)office (11 tools)pharmacy 藥局 (172 tools)reference 共用主檔 (208 tools)registry 病人與掛號 (210 tools)staff-schedule 醫師門診班表 (6 tools), chat flowworkforce 人力排班 (116 tools)

   Replace hismcp_gk_YOUR-KEY with your key. The address must end with /.

   Claude Code

   terminalCopy 複製Copied 已複製Copy failed

   claude mcp add --scope user --transport http his-clinical https://orbit-medical-systems.orbit-poc.com/mcp/clinical/ --header "Authorization: Bearer hismcp_gk_YOUR-KEY"
   claude mcp list

   Claude Desktop

   Needs Node.js 18 or newer (node -v). Settings, Developer, Edit Config, then paste into claude_desktop_config.json (merge with any existing mcpServers), save, and quit Claude Desktop completely before opening it again.

   claude_desktop_config.jsonCopy 複製Copied 已複製Copy failed

   {
     "mcpServers": {
       "his-clinical": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://orbit-medical-systems.orbit-poc.com/mcp/clinical/",
           "--header",
           "Authorization:${AUTH_HEADER}"
         ],
         "env": {
           "AUTH_HEADER": "Bearer hismcp_gk_YOUR-KEY"
         }
       }
     }
   }

   MCP Inspector (no AI, for testing)

   Start it, then on the left: Transport Type Streamable HTTP, URL below, Authentication, header Authorization with the value below, Connect.

   terminalCopy 複製Copied 已複製Copy failed

   npx @modelcontextprotocol/inspector

   URLCopy 複製Copied 已複製Copy failed

   https://orbit-medical-systems.orbit-poc.com/mcp/clinical/

   Authorization header valueCopy 複製Copied 已複製Copy failed

   Bearer hismcp_gk_YOUR-KEY

   You should see 應該看到： Claude Code: his-clinical with ✓ Connected. Claude Desktop: the entry running under Settings, Developer. Inspector: a green dot and Connected.

5. 5

   第一次呼叫 First call

   Ask your assistant: “Use his-clinical. Read its system card and tell me in five short points what you can do.” In Inspector: Tools, List Tools, pick a read tool, Run Tool. An empty list [] is a success: there is no data yet.

   • 401: the key is missing, mistyped, ended or revoked. The answer's hint names the header it expects.
   • 403: the shared service account may not use that tool. Tell the MCP admin the tool name.
   • Server disconnected (Claude Desktop): Node.js missing, the file saved as .txt, or Claude not fully quit.

   You should see 應該看到： a short list of what the system can do, or the tool's answer marked success.

Full reference (endpoints, chat identity, tokens, security): docs/mcp-usage-guide.md in the medical repo.