# Bảo mật Salesforce Hosted MCP Server: authentication, authorization và permission

[Philippe Ozil](https://homus.dev/speakers/philippe-ozil) · [Salesforce Developers](https://homus.dev/orgs/salesforce-developers)

> Ba lớp bảo mật khi agent gọi Salesforce hosted MCP server: OAuth qua External Client App, giới hạn truy cập, security model; demo với Claude Code.

Topics: Security, Agents, Dev Tools

Canonical: https://homus.dev/talks/secure-salesforce-hosted-mcp-servers-authentication-authorization-permissions

## 1. Ai sở hữu các action khi gọi một MCP server trên Salesforce

Philippe Ozil mở đầu bằng một câu hỏi: khi bạn gọi một MCP server trên nền tảng Salesforce, ai là người sở hữu các action đó? Anh nói đây là câu hỏi anh đã nghe nhiều lần, và anh sẽ thử trả lời nó (video đăng ngày 03/11/2026).

Anh giới thiệu mình là developer advocate ở Salesforce (phần mô tả video ghi chức danh Principal Developer Advocate, theo video đăng ngày 03/11/2026). Mục tiêu của video là giải thích cơ chế bảo mật của MCP trên Salesforce đang chạy thế nào tính đến lúc quay, và những gì sẽ thay đổi trong tương lai gần (theo video đăng ngày 03/11/2026).

![Philippe Ozil nói trước camera](https://homus.dev/photos/DopuqJIJhyU-0003.jpg)

Philippe Ozil, developer advocate ở Salesforce, đặt câu hỏi mở đầu: ai sở hữu các action khi agent gọi MCP server trên Salesforce (video đăng ngày 03/11/2026).

## 2. Ba bước theo thứ tự: authentication, authorization, permission control

Anh bắt đầu từ góc nhìn bảo mật tổng quát. Một bên là agent của bạn với MCP client của nó; agent này kết nối tới một hệ thống bên thứ ba đang chứa MCP server. Theo Philippe (video đăng ngày 03/11/2026), luôn có ba bước phải thực hiện, và phải theo một thứ tự nhất định.

Bước một là **authentication**: về cơ bản nó cho service biết agent là ai, danh tính (identity) của agent là gì. Để làm việc đó, thường người ta dùng credentials (theo video đăng ngày 03/11/2026).

Khi đã authenticate xong thì tới **authorization**: bước này gắn danh tính của agent với một số service mà agent được phép truy cập (theo video đăng ngày 03/11/2026).

Bước tiếp theo, bước số 3 trên sơ đồ, là **permission control**: nó quyết định primitive nào của MCP server được truy cập hay điều khiển một phần dữ liệu cụ thể nào. Theo Philippe (video đăng ngày 03/11/2026), điều này áp dụng cho tools, prompts và resources, những thứ cấu thành nên MCP server.

![Sơ đồ Agent với MCP Client đi xuống ba lớp lồng nhau: Authentication, Authorization, Permission Controls cho Tools, Prompts, Resources](https://homus.dev/photos/DopuqJIJhyU-0103.jpg)

Từ Agent và MCP Client đi xuống ba lớp lồng nhau, "1. Authentication", "2. Authorization" và "3. Permission Controls for MCP server's exposed primitives" gồm Tools, Prompts, Resources (slide trong video đăng ngày 03/11/2026).

## 3. Áp vào Salesforce: hosted MCP server, OAuth và External Client App

Đó là sơ đồ ở mức tổng quát. Tiếp theo anh áp nó vào bối cảnh Salesforce: vẫn đúng ba bước ấy, nhưng với metadata của Salesforce. Một bên là agent với MCP client; bên kia là Salesforce platform với dải hosted MCP server, gồm standard server và custom server. Theo Philippe (video đăng ngày 03/11/2026), mỗi server expose một số MCP tool đến từ nhiều công nghệ khác nhau như Apex, Flow, API hay prompt.

![Sơ đồ Agent với MCP Client bên trái, Platform bên phải với Hosted MCP Servers expose MCP Tools](https://homus.dev/photos/DopuqJIJhyU-0123.jpg)

Bối cảnh Salesforce: bên trái là Agent với MCP Client, bên phải là Platform với Hosted MCP Servers (Standard servers, Custom servers) expose các MCP Tools (Apex, Flows, APIs, Prompts...) (slide trong video đăng ngày 03/11/2026).

Làm sao nối hai thứ này với nhau? Đầu tiên, anh và nhóm dùng OAuth để authenticate với server. Để làm việc đó, Salesforce dùng một **External Client App**, gọi tắt là ECA; ECA cung cấp quyền truy cập vào platform. Và việc đầu tiên bạn cần làm là authenticate với ECA này (theo video đăng ngày 03/11/2026).

Philippe nói tiếp (video đăng ngày 03/11/2026): chuẩn OAuth có nhiều lựa chọn grant, nhưng với MCP server trong bối cảnh này, Salesforce chỉ hỗ trợ một grant, đó là **authorization code**. Điều đó có nghĩa là agent, hay MCP client ở phía agent, được gắn với một Salesforce user thật sự, chứ không phải một integration user, ngay ở bước số một này.

![Sơ đồ bước 1: MCP Client authenticate với OAuth 2.0 vào External Client App (ECA), ECA authorizes access tới Hosted MCP Servers](https://homus.dev/photos/DopuqJIJhyU-0203.jpg)

Bước 1 trên sơ đồ: MCP Client "Authenticate with OAuth 2.0" vào External Client App (ECA), và ECA "Authorizes access" tới Hosted MCP Servers (slide trong video đăng ngày 03/11/2026).

## 4. Giới hạn của ECA và lớp permission gắn với một Salesforce user

Anh muốn nhấn mạnh một điều: tính đến hôm quay, mà anh nói là tháng 10/2026, không có cách nào kiểm soát hay giới hạn danh sách MCP server mà ECA được truy cập. Anh nói sẽ có một tính năng bù cho việc thiếu độ chi tiết này (theo video đăng ngày 03/11/2026).

Còn thứ đang có, theo Philippe (video đăng ngày 03/11/2026), là khả năng chặn truy cập vào External Client App: giới hạn quyền truy cập cho những user có một số permission set hoặc profile nhất định, hoặc áp thêm giới hạn về dải IP được phép.

Cuối cùng, khi tới các tool, cũng có những cơ chế bảo mật tương tự để kiểm soát truy cập. Theo Philippe (video đăng ngày 03/11/2026), Salesforce dùng kết hợp sharing rules, permission sets và profiles để quyết định record nào, Apex class nào, flow nào được end user thực thi. Và anh nhắc: tất cả các cơ chế bảo mật này đều gắn với một Salesforce user, là user được xác định ở bước số một khi authenticate.

Sau đó bạn mới gọi được tools và prompts, nhưng tất cả những lời gọi đó sẽ giữ nguyên context và permission của user đã dùng để authenticate lúc đầu (theo video đăng ngày 03/11/2026).

![Sơ đồ đầy đủ: Permission Sets, Profiles, IP Ranges authorizes access cho ECA; Sharing Rules, Permission Sets, Profiles secures MCP Tools](https://homus.dev/photos/DopuqJIJhyU-0303.jpg)

Permission Sets, Profiles và IP Ranges "Authorizes access" vào ECA; Sharing Rules cùng Permission Sets và Profiles "Secures" các MCP Tools (slide trong video đăng ngày 03/11/2026).

## 5. Demo: tạo External Client App cho Claude Code

Xong phần lý thuyết, Philippe chuyển sang cấu hình trên Salesforce và tạo một External Client App, hướng dẫn từng bước (demo trong video đăng ngày 03/11/2026).

Trước hết, anh nhấn mạnh rằng cần tạo một External Client App cho mỗi loại agent hay client. Lý do anh đưa ra: nếu một trong số đó bị compromise, bạn có thể cô lập các session và revoke chúng từ xa (theo video đăng ngày 03/11/2026).

Anh tạo một client mới cho Claude Code, đặt tên "Claude Code Client", và điền email của mình với vai trò quản trị (demo trong video đăng ngày 03/11/2026).

![Form Basic Information của External Client App Manager, tên Claude Code Client, ô Contact Email còn trống](https://homus.dev/photos/DopuqJIJhyU-0403.jpg)

Form "Basic Information" trong External Client App Manager: External Client App Name là "Claude Code Client", API Name "Claude_Code_Client", Distribution State "Local"; bên dưới là các mục API (Enable OAuth Settings), Web App và Canvas App Settings (demo trong video đăng ngày 03/11/2026).

Tiếp theo là phần API: anh bật OAuth, rồi điền callback URL. Theo Philippe (video đăng ngày 03/11/2026), URL này tuỳ vào client bạn kết nối, mỗi agent có một callback URL khác nhau, và bạn sẽ phải đọc tài liệu của agent bạn dùng để biết callback URL là gì. Với Claude Code, anh dùng một callback local; sau khi điền, ô Callback URL ghi `http://localhost:38000/callback`.

Scope quyết định, ở mức tổng quát, những service nào trên platform được truy cập. Với MCP, theo Philippe (video đăng ngày 03/11/2026), trước hết anh xin refresh token để có thể kết nối lại về sau, khi đã thiết lập kết nối ban đầu. Và quan trọng nhất là scope MCP API: scope này cấp quyền truy cập vào tất cả các Salesforce hosted MCP server. Standard hay custom cũng không quan trọng, chúng đều nằm trong scope này. Anh nói về sau sẽ có một cơ chế khác để giới hạn danh sách MCP server được chọn, nhưng tính đến lúc quay thì gần như chỉ có vậy.

![App Settings với Callback URL localhost:38000/callback và hai Selected OAuth Scopes refresh_token và mcp_api](https://homus.dev/photos/DopuqJIJhyU-0503.jpg)

App Settings sau khi điền: Callback URL `http://localhost:38000/callback`, và hai scope đã chọn là "Perform requests at any time (refresh_token, offline_access)" và "Access Salesforce hosted MCP servers (mcp_api)" (demo trong video đăng ngày 03/11/2026).

Việc cuối cùng anh làm là cấp JSON Web Token cho user, rồi bấm Create (demo trong video đăng ngày 03/11/2026). Tài liệu Salesforce gọi tuỳ chọn này là "Issue JSON Web Token (JWT)-based access tokens for named users" (đọc ngày 15/11/2026).

Anh lưu ý thêm một chuyện mà anh nói không hẳn thuộc phạm vi video: khi tạo External Client App, việc kích hoạt có độ trễ. Nếu dùng nó quá sớm, bạn có thể gặp lỗi invalid client ID; theo Philippe (video đăng ngày 03/11/2026), bạn nên đợi từ 5 đến 10 phút để app được kích hoạt. Trang hướng dẫn tạo External Client App của Salesforce ghi app có thể mất tới 30 phút mới sẵn sàng cho MCP client (đọc ngày 15/11/2026).

## 6. Khoá ECA lại bằng OAuth policies

Trước khi dùng ECA, Philippe cho xem cách bảo vệ nó. Anh vào Policies, mở OAuth Policies và chuyển sang chế độ edit (demo trong video đăng ngày 03/11/2026).

Đầu tiên là trường **Permitted Users**. Theo Philippe (video đăng ngày 03/11/2026), mặc định mọi Salesforce user đều truy cập được app; trên màn hình, giá trị mặc định là "All users can self-authorize".

![OAuth Policies: Permitted Users đang là All users can self-authorize, phía dưới là App Authorization với refresh token policy và IP Relaxation](https://homus.dev/photos/DopuqJIJhyU-0543.jpg)

Phần OAuth Policies ở chế độ edit: Permitted Users đang là "All users can self-authorize". Bên dưới, mục App Authorization có Refresh Token Policy (đang chọn "Expire refresh token if not used for specific time", 30) và IP Relaxation "Enforce IP restrictions" (demo trong video đăng ngày 03/11/2026).

Nếu muốn giới hạn, điều mà anh rất khuyến nghị (video đăng ngày 03/11/2026), bạn chuyển trường này sang chỉ cho phép những user đã được duyệt trước. Bạn sẽ nhận một cảnh báo rằng việc này có thể khoá những user đã có quyền truy cập. Sau đó bạn có thể giới hạn truy cập theo profile hoặc theo những permission set được chọn.

Anh đã chuẩn bị sẵn một custom permission set đặt tên riêng cho đúng trường hợp này, và bật nó lên. Permission set này hoàn toàn không có gì bên trong: một permission set trống, không bật license nào. Theo Philippe (video đăng ngày 03/11/2026), điều quan trọng là permission set đó được gán cho user của anh.

![Select Profiles và Select Permission Sets, trong danh sách có MCP Access for Claude Code; Permitted Users đổi sang Admin approved users are pre-authorized](https://homus.dev/photos/DopuqJIJhyU-0603.jpg)

Sau khi đổi Permitted Users sang "Admin approved users are pre-authorized", hiện ra hai ô Select Profiles và Select Permission Sets; trong danh sách permission set có "MCP Access for Claude Code" (demo trong video đăng ngày 03/11/2026).

Theo Philippe (video đăng ngày 03/11/2026), bạn còn có thể đặt thêm giới hạn về thời hạn token và giới hạn IP theo các dải cụ thể. Anh không làm phần đó trong demo này, và lưu app lại.

## 7. Kết nối từ Claude Code và trang Allow Access

Giờ anh vào Claude Code. Màn hình báo có một MCP server cần authentication: "1 MCP server needs authentication · run /mcp" (demo trong video đăng ngày 03/11/2026).

![Terminal Claude Code với cảnh báo 1 MCP server needs authentication, run /mcp](https://homus.dev/photos/DopuqJIJhyU-0643.jpg)

Claude Code mở trong một project mẫu, dòng cảnh báo màu vàng "1 MCP server needs authentication · run /mcp" (demo trong video đăng ngày 03/11/2026).

Anh mở nó ra xem: đó là MCP server `sobject-all`, và anh yêu cầu authenticate với nó. Một trang trình duyệt mở ra, hỏi quyền truy cập cho một user cụ thể (demo trong video đăng ngày 03/11/2026).

![Trang Allow Access của Salesforce với Security Warning, Claude Code Client đang xin ba quyền, nút Deny và Allow](https://homus.dev/photos/DopuqJIJhyU-0658.jpg)

Trang "Allow Access?" của Salesforce: một khối Security Warning, rồi "Claude Code Client is asking to" truy cập identity URL service, truy cập Salesforce hosted MCP servers và thực hiện request bất cứ lúc nào, kèm hai nút Deny và Allow (demo trong video đăng ngày 03/11/2026).

Theo Philippe (video đăng ngày 03/11/2026), trên trang allow này bạn đang xác nhận danh tính của mình. Như vậy, mọi action mà các MCP server thực hiện từ thời điểm này trở đi đều sẽ dùng chính user này.

Anh bấm Allow, được đưa về Claude Code, và authentication thành công. Trong terminal, dưới lệnh `/mcp` hiện dòng "Authentication successful. Connected to sobject-all." (demo trong video đăng ngày 03/11/2026).

![Terminal Claude Code: lệnh /mcp và dòng Authentication successful. Connected to sobject-all.](https://homus.dev/photos/DopuqJIJhyU-0723.jpg)

Quay lại Claude Code: lệnh `/mcp` trả về "Authentication successful. Connected to sobject-all." (demo trong video đăng ngày 03/11/2026).

Theo Philippe (video đăng ngày 03/11/2026), từ đây nếu anh yêu cầu thay đổi accounts hay contacts của mình, tất cả các thao tác đó sẽ tuân theo mức kiểm soát truy cập đã cấp cho test user này.

## 8. Tóm lại ba lớp, và agentic identity sắp tới

Philippe tóm lại ba bước kiểm soát truy cập vào MCP server. Thứ nhất là authentication với External Client App. Thứ hai là authorization, mà theo anh (video đăng ngày 03/11/2026) đáng tiếc là tính đến lúc đó vẫn chỉ giới hạn ở một số cơ chế kiểm soát truy cập.

Anh nói trong tương lai sẽ có một tính năng tên là **agentic identity**, "hy vọng là vào cuối năm", và nó sẽ mở ra linh hoạt hơn nhiều trong việc kiểm soát MCP server nào ECA được truy cập và tool nào được chạy (theo video đăng ngày 03/11/2026).

Thứ ba là lớp Salesforce security model, quyết định MCP tool được làm gì và không được làm gì dựa trên security model đó (theo video đăng ngày 03/11/2026).

Ba lớp Philippe tóm lại ở cuối, lồng nhau như sơ đồ mở đầu của anh (theo video đăng ngày 03/11/2026).

## Nguồn và liên kết

- Tên gốc: Secure Salesforce Hosted MCP Servers: Authentication, Authorization & Permissions
- Sự kiện: [YouTube](https://homus.dev/events/youtube)
- Video gốc: [https://www.youtube.com/watch?v=DopuqJIJhyU](https://www.youtube.com/watch?v=DopuqJIJhyU)

- Kênh YouTube Salesforce Developers (Philippe Ozil): [youtube.com/channel/UCKORm8sxh3cheBpqs0akkhg](https://www.youtube.com/channel/UCKORm8sxh3cheBpqs0akkhg)

- Tài liệu Salesforce Hosted MCP Servers, phần tổng quan (đọc ngày 15/11/2026): [developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/hosted-mcp-servers-overview.html](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/hosted-mcp-servers-overview.html)

- Hướng dẫn tạo External Client App cho hosted MCP server: callback URL theo từng client, scope `mcp_api`, tuỳ chọn JWT và thời gian chờ kích hoạt (đọc ngày 15/11/2026): [developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/create-external-client-app.html](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/create-external-client-app.html)

Nguồn: https://homus.dev/talks/secure-salesforce-hosted-mcp-servers-authentication-authorization-permissions · cập nhật 2026-11-15
