# Nối MCP server vào declarative agent bằng M365 Agents Toolkit

[Matthew Devaney](https://homus.dev/speakers/matthew-devaney) · [Matthew Devaney](https://homus.dev/orgs/matthew-devaney)

> Ba declarative agent tạo bằng Microsoft 365 Agents Toolkit, nối với MCP server của Microsoft Learn, Atlassian và GitHub qua ba kiểu authentication.

Topics: Agents, Dev Tools, Security

Canonical: https://homus.dev/talks/m365-agents-toolkit-connect-mcp-server-to-declarative-agent

## 1. Ba declarative agent, ba MCP server

Matthew Devaney mở đầu: hôm nay anh sẽ build ba declarative agent bằng Microsoft 365 Agents Toolkit, và kết nối ba agent đó với ba MCP server khác nhau (theo video đăng ngày 15/11/2026).

Lý do anh làm nhiều ví dụ như vậy, theo lời anh, là có rất nhiều cách khác nhau mà bạn sẽ phải dùng để nối MCP server vào declarative agent của mình (theo video đăng ngày 15/11/2026). Anh nghĩ rằng càng cho xem nhiều ví dụ thì bạn càng có nhiều khả năng làm thành công khi tự mình làm việc này.

Ba agent Matthew build trong video đăng ngày 15/11/2026, mỗi agent nối với một MCP server và một kiểu authentication khác nhau.

## 2. Microsoft Learn MCP server: ba tool và địa chỉ endpoint

Agent đầu tiên dùng Microsoft Learn MCP server. Anh nói có thể tìm MCP server này ở github.com/MicrosoftDocs/mcp (video đăng ngày 15/11/2026).

MCP server này làm gì? Theo Matthew (video đăng ngày 15/11/2026), đây là một MCP server chính thức do Microsoft đưa ra, và nó có ba tool. Nó có thể tìm tài liệu trên MS Learn. Nó có thể fetch tài liệu và chuyển sang Markdown. Và nó có thể tìm code example trong tài liệu.

![Bảng Currently Supported Tools của Microsoft Learn MCP server với ba tool](https://homus.dev/photos/NA8a9LORewI-0103.jpg)

Phần "Currently Supported Tools" trong tài liệu của Microsoft Learn MCP server mà Matthew mở trong video đăng ngày 15/11/2026: `microsoft_docs_search` (semantic search trên tài liệu kỹ thuật chính thức của Microsoft), `microsoft_docs_fetch` (fetch một trang tài liệu và chuyển sang markdown) và `microsoft_code_sample_search` (tìm code snippet và example chính thức của Microsoft/Azure).

Theo anh, điểm hay nhất của MCP server này là bạn lấy được thông tin theo thời gian thực (theo video đăng ngày 15/11/2026). Khi tài liệu được cập nhật, bạn có thể chắc rằng agent đang fetch thông tin mới nhất và đáng tin cậy nhất.

Đến đây, anh nói, ta đã biết MCP server này làm gì và có những tool nào. Việc tiếp theo phải tìm ra là MCP server này nằm ở đâu, và thông tin đó cũng có trong tài liệu. Kéo xuống dưới, anh thấy MCP server này ở địa chỉ sau, và anh sẽ đưa URL này cho declarative agent (theo video đăng ngày 15/11/2026):

```
https://learn.microsoft.com/api/mcp
```

Điều còn lại phải tìm ra là declarative agent cần kiểu authentication nào để kết nối tới MCP server này. Theo Matthew (video đăng ngày 15/11/2026), tài liệu của Microsoft là thông tin công khai, nên declarative agent đầu tiên sẽ kết nối tới MCP server này mà không cần authorization, và điều đó khiến nó là một ví dụ đầu tiên khá tốt.

## 3. Agent thứ nhất: tạo trong Agents Toolkit, authentication None

Anh quay lại Microsoft 365 Agents Toolkit trong VS Code và bắt đầu một agent hoàn toàn mới (demo trong video đăng ngày 15/11/2026). Anh chọn declarative agent, rồi chọn add an action, vì anh muốn thêm một MCP server. Tiếp theo là ô để copy và paste URL của MCP server, ở đây là URL của Microsoft Learn.

Sau đó là bước chọn kiểu authentication (demo trong video đăng ngày 15/11/2026). Anh nói tài liệu MS Learn là thông tin công khai, nên ở đây anh chọn None.

![Hộp chọn Select Authentication Type trong Microsoft 365 Agents Toolkit với bốn lựa chọn](https://homus.dev/photos/NA8a9LORewI-0243.jpg)

Hộp "Select Authentication Type" của Agents Toolkit trong video đăng ngày 15/11/2026 có bốn lựa chọn: OAuth (with static registration), toolkit sẽ hỏi client id, client secret và các scope tuỳ chọn; OAuth (with dynamic registration), MCP server đăng ký client lúc chạy, không cần thêm thông tin; Entra SSO, toolkit sẽ hỏi client id của Entra app; và None, MCP server không yêu cầu authentication.

Tiếp theo anh được chọn nơi agent này sẽ nằm: anh chọn một folder (demo trong video đăng ngày 15/11/2026). Rồi cần một application name: anh đặt là MS Learn MCP Agent và nhấn Enter.

Vậy là đã có declarative agent, và agent đó đã kết nối với Microsoft Learn MCP server (demo trong video đăng ngày 15/11/2026). Matthew hỏi: khá đơn giản, đúng không? Theo anh, đó là vì MCP server này không yêu cầu authentication nào, và phần sau của video sẽ có những ví dụ cần authentication.

## 4. Hai file của agent: ai-plugin.json và declarativeAgent.json

Thứ tiếp theo anh muốn cho xem là file AI plugin JSON (`ai-plugin.json`) thuộc agent. Theo Matthew (video đăng ngày 15/11/2026), đây là nơi chứa mọi chi tiết của MCP server: URL dùng để kết nối tới server đó, và kiểu authentication là None, đúng như lúc anh thiết lập. Một đoạn của file trên màn hình trong video đăng ngày 15/11/2026, phần `runtimes`:

```
"runtimes": [
{
"type": "RemoteMCPServer",
"spec": {
"url": "https://learn.microsoft.com/api/mcp"
},
"run_for_functions": [
"*"
],
"auth": {
"type": "None"
}
}
]
```

Thứ khác cũng thay đổi là file declarative agent JSON (`declarativeAgent.json`). Theo Matthew (video đăng ngày 15/11/2026), đây là nơi bạn thấy mọi action mà agent được phép dùng. Ở đây có một action, và nó trỏ tới file AI plugin JSON.

![File declarativeAgent.json trong VS Code với mục actions trỏ tới ai-plugin.json](https://homus.dev/photos/NA8a9LORewI-0403.jpg)

File `declarativeAgent.json` của agent MS Learn MCP Agent trong video đăng ngày 15/11/2026: ngoài `name`, `description`, `instructions` và một conversation starter, mục `actions` có một action với `"id": "action_1"` và `"file": "ai-plugin.json"`. Cột bên trái là cấu trúc project: appPackage (ai-plugin.json, color.png, declarativeAgent.json, instruction.txt, manifest.json, outline.png), env, evals, m365agents.yml, README.md.

Theo Matthew (video đăng ngày 15/11/2026), khi agent quyết định đã đến lúc dùng MCP server, nó sẽ xem file plugin JSON đó, gọi nó, và dùng các tool đã thấy trong tài liệu để giúp trả lời câu hỏi.

## 5. Provision, bật developer mode và hỏi về bản phát hành Copilot Studio

Giờ anh provision agent này để dùng: trong Microsoft 365 Agents Toolkit, anh bấm Provision, và nói một lát nữa chắc là ta thấy cả năm bước hoàn tất (demo trong video đăng ngày 15/11/2026). Khi provision xong, anh mở Microsoft 365 Copilot, vào mục Agents, và agent vừa provision đã có ở đó.

Trước khi đi tiếp, anh gõ một lệnh mà anh gọi là lệnh "super secret" (demo trong video đăng ngày 15/11/2026). Theo Matthew, lệnh này cho bạn thấy agent đang tương tác với MCP server ra sao và đang dùng tool nào, và bật nó lên khi bạn đang test là một ý hay. Lệnh anh gõ vào ô chat, như trên màn hình trong video đăng ngày 15/11/2026:

```
-developer on
```

Agent trả lời "Successfully enabled developer mode." (demo trong video đăng ngày 15/11/2026). Rồi anh đặt câu hỏi: "Tell me the most recent Copilot Studio release and what features are included". Anh nghĩ đây là một câu hỏi rất hợp để hỏi Microsoft Learn MCP server, vì MCP server này bảo đảm cho ta truy cập thông tin theo thời gian thực (theo video đăng ngày 15/11/2026).

![Câu trả lời của MS Learn MCP Agentdev trong Microsoft 365 Copilot về các tính năng Copilot Studio](https://homus.dev/photos/NA8a9LORewI-0523.jpg)

Câu trả lời của agent "MS Learn MCP Agentdev" trong Microsoft 365 Copilot (demo trong video đăng ngày 15/11/2026): câu mở đầu ghi "As of September 21, 2026", nhắc tới bản "July 2026 "What's New" release", rồi có heading "Key Copilot Studio Features Released in July 2026" với các mục như Agent Identity and Governance và GitHub Copilot Harness Enhancements (Preview).

Matthew nói: "nhìn kìa", câu trả lời cho thấy bản phát hành gần nhất là hôm nay, và nó có đủ các tính năng đi kèm (demo trong video đăng ngày 15/11/2026). Trên màn hình, câu trả lời của agent ghi mốc "As of September 21, 2026" và nói tới bản "July 2026 "What's New" release".

Kéo xuống cuối câu trả lời, có một thẻ agent debug info (demo trong video đăng ngày 15/11/2026). Mở thẻ này ra, anh thấy MCP server đã thực sự dùng những action nào: ở đây nó dùng tool search và tool fetch. Kéo tiếp xuống, có thể thấy action nào được thực thi theo thứ tự nào, để có một chút hình dung về cách agent đi tới câu trả lời.

![Thẻ agent debug info với danh sách function, trạng thái Matched và Selected, và Executed Actions](https://homus.dev/photos/NA8a9LORewI-0543.jpg)

Thẻ debug info của MS Learn MCP Agent trong video đăng ngày 15/11/2026: cả ba function đều "Matched", nhưng chỉ `microsoft_docs_search` và `microsoft_docs_fetch` có dấu tick ở cột "Selected", còn `microsoft_code_sample_search` có dấu X; phần "Executed Actions" ghi số 2.

Đó là ví dụ đầu tiên: cách kết nối một agent tới một MCP server không có authentication (theo video đăng ngày 15/11/2026).

## 6. Agent thứ hai: Atlassian MCP server và một space trên Jira

Declarative agent thứ hai sẽ kết nối với Atlassian MCP server. Theo Matthew (video đăng ngày 15/11/2026), đây là MCP server chính thức cho Jira, Confluence và một loạt app khác mà Atlassian làm ra, và bạn có thể tìm nó ở github.com/atlassian/atlassian-mcp-server.

Điều thú vị anh sẽ làm là nối nó với Jira. Anh giải thích (video đăng ngày 15/11/2026): Jira là một bộ công cụ quản lý dự án; bạn có thể thêm các task cần làm trong dự án phần mềm, xếp chúng vào to do, in progress và completed, và theo dõi toàn bộ công việc ở đó. Anh sẽ dùng MCP server để tạo task mới trong Jira.

Với MCP server trước, anh và người xem chỉ đọc thông tin. Lần này là làm một việc thật: kết nối tới Jira và tạo task mới bên trong nó, tức là ghi vào Jira. Matthew nói anh thấy điều đó khá thú vị (video đăng ngày 15/11/2026).

Nếu muốn làm theo, anh nói bạn có thể đăng ký Jira miễn phí: chỉ cần điền email vào ô trên trang đăng ký là có một tài khoản Jira test mới (theo video đăng ngày 15/11/2026). Đăng ký xong thì quay lại làm tiếp phần còn lại của ví dụ.

Sau khi đăng ký Jira xong, bạn tới một màn hình gọi là space (demo trong video đăng ngày 15/11/2026). Theo Matthew, một space là nơi bạn sắp xếp mọi task của một dự án. Ở đây có Task 1 và Task 2, và các task rơi vào những nhóm khác nhau: to do, in progress, review và done. Việc anh sẽ làm với declarative agent là dùng Atlassian MCP server để tạo một task hoàn toàn mới tên là Task 3.

![Board của space My Software Team trên Jira với Task 1 ở To Do và Task 2 ở In Progress](https://homus.dev/photos/NA8a9LORewI-0743.jpg)

Space "My Software Team" trên Jira trước khi agent chạy (demo trong video đăng ngày 15/11/2026): cột To Do có Task 1 (SCRUM-1), cột In Progress có Task 2 (SCRUM-2), cột In Review đang trống.

## 7. Tạo agent Atlassian với OAuth dynamic registration

Anh quay lại tài liệu của Atlassian để tìm địa chỉ MCP server và copy nó vào clipboard (demo trong video đăng ngày 15/11/2026). Đoạn "Important" anh bôi đen trên trang ghi "v2 is now the recommended version" và địa chỉ sau:

```
https://mcp.atlassian.com/v2/mcp
```

Rồi anh quay lại VS Code, bắt đầu một declarative agent mới, chọn add an action, chọn bắt đầu với một MCP server, và paste URL của MCP server vào ô (demo trong video đăng ngày 15/11/2026).

Lần này anh dùng OAuth with dynamic registration, một kiểu authentication khác (demo trong video đăng ngày 15/11/2026). Vì sao cần kiểu khác? Theo Matthew, Jira yêu cầu bạn là người dùng đã đăng nhập thì mới làm được việc. Anh nói anh biết phải chọn kiểu nào bằng cách đọc tài liệu.

![Hộp Select Authentication Type với OAuth with dynamic registration được chọn](https://homus.dev/photos/NA8a9LORewI-0843.jpg)

Lần này Matthew chọn "OAuth (with dynamic registration)", mô tả trên hộp chọn là "MCP server registers a client at runtime; no extra details needed." (demo trong video đăng ngày 15/11/2026).

Tiếp theo anh chọn folder và nhập application name: Atlassian MCP Agent. Anh hỏi lại không biết mình đã đánh vần đúng chữ Atlassian chưa, và nói đó là một chữ khó (video đăng ngày 15/11/2026). Rồi anh nhấn Enter, và declarative agent thứ hai cho Atlassian đã được tạo.

Anh mở các file để xem có chi tiết nào khác so với agent trước, agent có authentication type là None (demo trong video đăng ngày 15/11/2026).

## 8. OAuthPluginVault và reference_id

Trong file AI plugin JSON, anh thấy agent này trỏ tới endpoint MCP của atlassian.com, version 2 (demo trong video đăng ngày 15/11/2026). Authentication type là OAuth plugin vault, và bên dưới có một reference ID. Trước đó chỗ này ghi None, còn ở đây là OAuth plugin vault. Một đoạn của file trên màn hình trong video đăng ngày 15/11/2026:

```
"runtimes": [
{
"type": "RemoteMCPServer",
"spec": {
"url": "https://mcp.atlassian.com/v2/mcp"
},
"run_for_functions": [
"*"
],
"auth": {
"type": "OAuthPluginVault",
"reference_id": "${{MCP_DA_AUTH_ID_MCPATLASSI}}"
}
}
]
```

Điều đó có nghĩa gì? Theo Matthew (video đăng ngày 15/11/2026), trước hết nó cho agent biết sẽ dùng OAuth để xác thực. Thứ hai, mọi secret được sinh ra, mọi secret cần để xác thực, sẽ được cất trong một vault, một key vault.

Và đó là lý do reference ID này không hard-code một giá trị secret, theo lời anh (video đăng ngày 15/11/2026). Giá trị đó sẽ được lấy khi đăng nhập, nhưng nó sẽ không bị hard-code ở bất kỳ đâu trong agent, vì làm vậy là một cách làm bảo mật không mấy hay.

Xem xét xong một chút, anh provision agent này: bấm nút Provision, và nó chạy qua cả sáu bước (demo trong video đăng ngày 15/11/2026). Rồi anh vào M365 Copilot, mở menu Agents, và agent mới tinh Atlassian MCP Agent đã có ở đó.

## 9. Đăng nhập Atlassian, màn hình Authorize App và form xác nhận

Anh đưa cho agent prompt sau, như trên màn hình trong video đăng ngày 15/11/2026:

```
Create a new task with the title "Task 3" in the "My Software Team" and then put it in SCRUM Sprint 0
```

Việc đầu tiên agent làm là yêu cầu đăng nhập vào Atlassian (demo trong video đăng ngày 15/11/2026). Vì sao nó hỏi vậy? Theo Matthew, đó là vì mọi task trong Atlassian đều phải được làm bởi một người dùng đã đăng nhập. Anh đi qua các bước đăng nhập, bấm next, rồi tới màn hình Authorize App.

Theo Matthew (video đăng ngày 15/11/2026), đây là chỗ mà chúng ta, với tư cách người dùng cuối, có quyền kiểm soát những gì agent sẽ được làm thay mình. Có thể cho nó chỉ đọc thông tin từ Jira. Cũng có thể cho nó ghi thông tin ngược lại vào Jira, và cũng có thể dùng nó để search Jira. Mở hết các menu này ra thì thấy quyền kiểm soát rất chi tiết, rất nhiều lựa chọn khác nhau về những gì có thể làm.

![Màn hình Authorize App của Atlassian với ba nhóm quyền Read, Write và Search](https://homus.dev/photos/NA8a9LORewI-1123.jpg)

Màn hình Authorize App của Atlassian trong video đăng ngày 15/11/2026: app "mcpatlassi" xin truy cập tài khoản Atlassian, phần Domains ghi `https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect`, và có ba nhóm quyền Read, Write, Search, đều đang được tick; cuối trang ghi "24 out of 24 permissions selected".

Trong ví dụ này anh để bật hết read, write và search, nhưng anh nói bạn có thể muốn làm khác đi cho agent của mình (video đăng ngày 15/11/2026). Anh bấm Accept.

Thứ tiếp theo hiện lên là một consent form nữa, hỏi xem bạn có muốn cho agent tạo task đó hay không (demo trong video đăng ngày 15/11/2026). Matthew nói anh nghĩ đây là một điều rất tốt, vì bạn, người dùng cuối, luôn nên có quyền kiểm soát việc agent làm, nhất là khi nó đang ghi vào một database production (theo video đăng ngày 15/11/2026). Anh bấm confirm.

## 10. Task 3 xuất hiện trên board và debug info

Agent báo lại rằng nó đã tạo task trong Jira và đặt vào sprint 0 (demo trong video đăng ngày 15/11/2026). Trên màn hình, câu trả lời của "Atlassian MCP Agentdev" mở đầu bằng "I created the Jira task and added it to the requested sprint." và ghi Project là My Software Team (project key: SCRUM).

Anh quay lại board, và Task 3 đã nằm ở cột To Do (demo trong video đăng ngày 15/11/2026). Matthew nói vậy là tuyệt.

![Board Jira sau khi agent chạy: Task 3 nằm ở cột To Do](https://homus.dev/photos/NA8a9LORewI-1229.jpg)

Board của space My Software Team sau khi agent chạy (demo trong video đăng ngày 15/11/2026): cột To Do giờ có hai thẻ, Task 1 (SCRUM-1) và Task 3 (SCRUM-7).

Kéo xuống phần agent debug info, có thể thấy agent đã quyết định dùng tool nào: tool create Jira issue (demo trong video đăng ngày 15/11/2026). Anh nói có vẻ như nó gần như chỉ dùng mỗi tool đó, và phần executed actions cũng chỉ có create Jira issue. Trên màn hình, trong danh sách function, chỉ `createJiraIssue` có dấu tick ở cột Selected.

Theo Matthew, vậy là hoàn hảo, thêm một agent nữa xong (video đăng ngày 15/11/2026). Atlassian MCP Agent đăng nhập bằng OAuth with dynamic registration, và nó cho phép tạo một task bên trong Jira, tức là thực sự ghi thông tin.

## 11. Agent thứ ba: GitHub MCP server, toolset và scope

Declarative agent cuối cùng anh và người xem build cùng nhau hôm nay sẽ kết nối với GitHub MCP server. Matthew nói (video đăng ngày 15/11/2026): bạn biết GitHub là gì, đúng không? Đó là nơi làm version control, nơi bạn lưu toàn bộ code của mình. Có thể tìm MCP server này ở github.com/github/github-mcp-server, và giống các lần trước, có thể tìm endpoint bằng cách kéo qua tài liệu. Đây là địa chỉ cần dùng.

MCP server này làm gì? Theo Matthew (video đăng ngày 15/11/2026), nó có quyền truy cập tất cả các toolset có sẵn này, rất nhiều thứ: nó có thể đọc và ghi vào repo, lấy issue, và làm đủ loại action quản trị thú vị. Anh nói điều đó khá tuyệt, có rất nhiều việc bạn có thể làm với GitHub MCP server này, và nó khá là mạnh. Trên màn hình là bảng "Available Toolsets" của repo, gồm những dòng như `context`, `actions`, `code_quality`, `code_security`, `copilot`, `copilot_issue_intents`, `dependabot`.

Phần tài liệu khác cần dùng là tài liệu về scope. Theo Matthew (video đăng ngày 15/11/2026), scope kiểu như cắt bớt bộ tool mạnh mà anh vừa kể, và cho agent biết agent thực sự được phép làm gì. Nó có nên chỉ ở trong các repo public, hay cũng xem cả repository private?

![Bảng Available scopes trong tài liệu GitHub về OAuth apps](https://homus.dev/photos/NA8a9LORewI-1423.jpg)

Bảng "Available scopes" trong tài liệu "Scopes for OAuth apps" của GitHub mà Matthew mở trong video đăng ngày 15/11/2026: `(no scope)` cho quyền chỉ đọc thông tin public; `repo` cho quyền đầy đủ với repository public và private; `repo:status` và `repo_deployment` cho các quyền hẹp hơn.

Vậy nên, anh nói, cần cung cấp cả endpoint lẫn một số scope (theo video đăng ngày 15/11/2026). Và trước khi vào declarative agent trong M365 Agents Toolkit, phải làm một việc trên GitHub.

## 12. Tạo một OAuth app trên GitHub

Bạn mở tài khoản GitHub của mình. Matthew nói anh đoán là bạn có một tài khoản, vì bạn là developer; nếu chưa thì hãy đăng ký, bạn sẽ không hối tiếc (video đăng ngày 15/11/2026).

Các bước anh làm (demo trong video đăng ngày 15/11/2026): vào Settings, kéo xuống Developer Settings, và tạo một OAuth app mới gắn với tài khoản. Anh đặt application name là M365 Agents Toolkit, nhưng anh nói bạn có thể đặt tên gì tuỳ ý. Theo anh, homepage URL không quan trọng, và anh chỉ để nó trỏ tới website cá nhân của mình.

Với redirect URI, anh dùng đúng địa chỉ anh chỉ trên màn hình, và dặn hãy nhìn kỹ rồi gõ chính xác những gì bạn thấy (demo trong video đăng ngày 15/11/2026). Theo anh, đây là redirect URI cho declarative agent. Rồi anh bấm register application.

Anh có client ID, thứ anh sẽ cần để thiết lập declarative agent và MCP server (demo trong video đăng ngày 15/11/2026). Anh cũng cần tạo một client secret mới. Anh bấm tạo secret, GitHub yêu cầu xác minh, anh nhập mã, bấm verify, và có được secret mới. Anh nói đến đây có vẻ đã có đủ mọi thứ cần thiết.

Thứ tự các bước Matthew làm trên GitHub trong video đăng ngày 15/11/2026; client ID và client secret là hai thứ anh cần cho bước tạo agent.

## 13. Tạo agent GitHub với OAuth static registration

Giờ anh tạo declarative agent bằng toolkit: mở VS Code, vào toolkit, mở show and run commands, chọn declarative agent (demo trong video đăng ngày 15/11/2026). Giống như trước, anh thêm một action và bắt đầu với một MCP server, rồi copy và paste URL đã thấy trong tài liệu. Trên màn hình, ô "MCP Server URL" ghi:

```
https://api.githubcopilot.com/mcp
```

Lần này anh chọn static registration, vì theo anh đó là điều GitHub MCP server yêu cầu: nó không cho phép dynamic registration (theo video đăng ngày 15/11/2026). Anh nói anh đã đọc tài liệu và thấy đó là cách nó cần.

Ở bước tiếp theo anh nhập client ID lấy từ trang GitHub (demo trong video đăng ngày 15/11/2026). Anh dặn đừng để thừa khoảng trắng ở cuối, vì nó sẽ gây rắc rối. Rồi anh quay lại lấy secret và paste vào ô tiếp theo.

Với scope, anh có sẵn một số scope cấu hình trước (demo trong video đăng ngày 15/11/2026). Anh nói bạn có thể dùng y hệt những scope này, còn nếu không thì luôn có thể quay lại trang tài liệu về scope để tự chọn scope cho mình. Trên màn hình, ô "OAuth Scopes (optional)" anh nhập là:

```
repo read:org read:user
```

![Ô OAuth Scopes optional trong VS Code với giá trị repo read:org read:user](https://homus.dev/photos/NA8a9LORewI-1722.jpg)

Bước "OAuth Scopes (optional)" của Agents Toolkit trong video đăng ngày 15/11/2026, với ba scope Matthew nhập sẵn; cột bên trái là màn hình chào của Microsoft 365 Agents Toolkit.

Anh nhấn Enter, chọn nơi agent sẽ nằm, và đặt tên là GitHub MCP Agent (demo trong video đăng ngày 15/11/2026).

## 14. Client ID và client secret nằm ở Teams Developer Portal

Có GitHub MCP Agent rồi, anh xem nhanh file AI plugin JSON (demo trong video đăng ngày 15/11/2026). Ở đó có endpoint vừa nhập, và authentication type cũng là OAuth plugin vault. Anh nói nó trông không khác mấy so với lúc dùng dynamic registration. Một đoạn của file trên màn hình trong video đăng ngày 15/11/2026:

```
"auth": {
"type": "OAuthPluginVault",
"reference_id": "${{MCP_DA_AUTH_ID_APIGITHUBC}}"
}
```

Vậy, anh hỏi, những key đã nhập đi đâu, client secret và client ID đi đâu? Theo Matthew (video đăng ngày 15/11/2026), khi anh provision agent này, chúng sẽ nằm trong Teams Developer Portal. Và anh nói đó là điều tốt, vì bạn không muốn chúng bị hard-code bên trong agent; đó là lý do có giá trị placeholder ở đây.

Nhưng trông nó thế nào, và tìm Teams Developer Portal ở đâu? Anh vào Google gõ "Teams Dev Portal", và nói nó có lẽ gần như là kết quả đầu tiên (demo trong video đăng ngày 15/11/2026). Trong portal, anh vào Tools, rồi OAuth Client Registration, và thấy registration của mình cùng client ID ở đó. Theo Matthew, đó là nơi những thứ này được cất giữ an toàn (video đăng ngày 15/11/2026).

## 15. Thử agent GitHub và tóm lại ba cách kết nối

Agent đã provision, nên anh vào app M365 Copilot, quay lại mục Agents, mở GitHub MCP Agent vừa tạo, và hỏi nó repository nào của người dùng Matthew Devaney có nhiều star nhất (demo trong video đăng ngày 15/11/2026).

Anh phải đăng nhập vào GitHub MCP Agent giống như trước, giống như với dynamic registration (demo trong video đăng ngày 15/11/2026). Nhưng lần này anh chỉ bấm authorize cho tài khoản của mình, rồi xác minh. Anh nói không có thêm bước thiết lập nào khác, đúng không? Vì anh đã định nghĩa trước các scope mà agent bị giới hạn, và đã cung cấp trước client secret và client ID.

Giờ agent đi xem repository của anh (demo trong video đăng ngày 15/11/2026). Nó đang xếp việc, anh bấm allow để agent được dùng MCP server, và câu trả lời trả về. Repository số một tên đơn giản là power, dành cho PowerApps custom functions. Tiếp theo là Copilot-Studio-Tutorials, nơi chứa tất cả các file tutorial của anh, và vài repository khác. Anh hỏi: khá hay, đúng không?

![Câu trả lời của Github MCP Agentdev: bảng repository xếp theo số star](https://homus.dev/photos/NA8a9LORewI-2003.jpg)

Câu trả lời của "Github MCP Agentdev" (demo trong video đăng ngày 15/11/2026): bảng các repository public nhiều star nhất, xếp theo star: power (46), Copilot-Studio-Tutorials (21), copilot-studio (18), pa-desktop-blogs (7), powerappseditabletable (6).

Vậy là anh đã nối các agent với ba MCP server khác nhau (demo trong video đăng ngày 15/11/2026). Một cái không có auth, đó là Microsoft Learn MCP server. Một cái dùng OAuth và dynamic registration, đó là Atlassian MCP server. Và cái cuối, GitHub MCP server, dùng OAuth và static registration.

Ba cách kết nối mà Matthew tóm lại ở cuối video đăng ngày 15/11/2026, kèm việc mỗi agent làm trong demo.

Matthew kết thúc: đó là tất cả, video chỉ có vậy.

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

- Tên gốc: M365 Agents Toolkit: Connect MCP Server To Declarative Agent
- Sự kiện: [YouTube](https://homus.dev/events/youtube)
- Video gốc: [https://www.youtube.com/watch?v=NA8a9LORewI](https://www.youtube.com/watch?v=NA8a9LORewI)

- Kênh YouTube Matthew Devaney (Matthew Devaney): [youtube.com/channel/UCuBK42yA0I1sfmsZTCL_t2w](https://www.youtube.com/channel/UCuBK42yA0I1sfmsZTCL_t2w)

- Microsoft Learn MCP server, repo chính thức; README ghi endpoint `[https://learn.microsoft.com/api/mcp](https://learn.microsoft.com/api/mcp)` và ba tool `microsoft_docs_search`, `microsoft_docs_fetch`, `microsoft_code_sample_search` (đọc ngày 20/11/2026): [github.com/microsoftdocs/mcp](https://github.com/microsoftdocs/mcp)

- Atlassian MCP server, repo chính thức; README ghi endpoint `[https://mcp.atlassian.com/v2/mcp](https://mcp.atlassian.com/v2/mcp)` (đọc ngày 20/11/2026): [github.com/atlassian/atlassian-mcp-server](https://github.com/atlassian/atlassian-mcp-server)

- GitHub MCP server, repo chính thức; README ghi remote endpoint `[https://api.githubcopilot.com/mcp/](https://api.githubcopilot.com/mcp/)` (đọc ngày 20/11/2026): [github.com/github/github-mcp-server](https://github.com/github/github-mcp-server)

- Tài liệu GitHub "Scopes for OAuth apps" (đọc ngày 20/11/2026): [docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps)

Nguồn: https://homus.dev/talks/m365-agents-toolkit-connect-mcp-server-to-declarative-agent · cập nhật 2026-11-20
