You add SePay to Cursor with one configuration block in an mcp.json file. Cursor opens the browser for you to sign in to SePay and grant access.
Before you start
- The Cursor desktop app, signed in to a Cursor account.
- Access to the AI Agent page on SePay, see requirements on SePay.
Connection steps
The steps follow Cursor as of November 2026 and Cursor's guide. If Cursor changes, look for items with the same meaning or contact SePay for help.
Step 1: Get the Cursor config on SePay
- Sign in to my.sepay.vn.
- In the left menu, under Tích hợp & Thông báo, select AI Agent.
- Select Tạo kết nối (Create connection) at the top right.
- Under Bạn dùng ứng dụng AI nào? (Which AI app do you use?), choose Cursor.
The Cấu hình cho Cursor (Cursor config) step shows a config block for the mcp.json file, with the address https://my.sepay.vn/mcp and the Client ID sepay-mcp already in it. Select the copy button to paste it into Cursor in Step 2.

Step 2: Add SePay to Cursor
- In Cursor, select Customize in the left sidebar.
- Select the MCPs tab.
- At the bottom of the list, select New MCP Server (Add a Custom MCP Server). Cursor opens
~/.cursor/mcp.jsonin the right pane. - Paste this configuration into the file and save it (
Ctrl+S, on macOSCmd+S):
{
"mcpServers": {
"sepay": {
"url": "https://my.sepay.vn/mcp",
"auth": { "CLIENT_ID": "sepay-mcp" }
}
}
}If the file already has other MCP servers, add only the "sepay": { ... } block inside mcpServers, separated from the block before it by a comma.
The auth block with CLIENT_ID sepay-mcp is required. Without it, Cursor can't sign in to SePay. No CLIENT_SECRET is needed.
To use SePay in one project only, put the configuration above in .cursor/mcp.json in that project's root folder.

Step 3: Sign in to SePay from Cursor
Once the file is saved, SePay shows under Needs Attention on the MCPs tab as Sepay (Cursor capitalizes sepay), with Needs authentication. Select Authenticate on that row. Cursor opens the browser to the SePay access screen.
Grant Cursor access on SePay
Step 4: Grant access
Cursor uses the shared Client ID sepay-mcp, so SePay shows the Ứng dụng khác muốn truy cập dữ liệu SePay của bạn (Another app wants to access your SePay data) screen without Cursor's name. On that screen:
- Turn each data group on or off under AI được phép xem (AI may view).
- If needed, open Ẩn bớt thông tin cho ứng dụng này (Hide more information for this app).
- Select Đồng ý cấp quyền (Grant access).
What each data group and hiding option means is in SePay MCP permissions and security.

SePay shows a page saying access was granted, then returns to Cursor after a few seconds. If it doesn't, select Hoàn tất kết nối (Finish connecting).
When Sepay moves to Connected on the MCPs tab, with a count of tools enabled, the connection is done.

On the SePay AI Agent page, this connection shows as SePay MCP in the Ứng dụng đã kết nối (Connected apps) tab. You can rename it to something easy to recognize, for example "Cursor work laptop", see Manage connections.
Ask Cursor about your SePay data
Select New Chat in Cursor's left sidebar and ask, for example "My transactions this month". Cursor may ask you before using a SePay tool: approve to continue. When Cursor calls a sepay tool and answers from the transactions on your account, the connection works. Here sepay is the name you gave SePay MCP in mcp.json, not the SePay CLI.

Look up SePay integration docs
Cursor can read the docs on developer.sepay.vn through SePay MCP, even before you grant access. When you ask an integration question, it reads the relevant docs page and answers with a link to it. Open the link to check before using the code. For example:
- "Write a Node.js endpoint that receives SePay webhooks and skips duplicate transactions."
- "How does the SePay payment gateway send IPN, and what must I return?"
- ...

Disconnect Cursor
Delete the "sepay": { ... } block from ~/.cursor/mcp.json and save; Sepay disappears from the MCPs tab.
This does not revoke the connection on SePay. To revoke it, go to the AI Agent page, see Manage connections.
Common errors
Common SePay MCP errors are in Common errors when connecting SePay MCP.
Next steps
- See sample questions for each kind of data in SePay MCP tools.
- Install SePay Skills so Cursor knows SePay's integration flows and security notes when writing integration code.