SePay MCP overview: connect AI apps to SePay

SePay MCP (Model Context Protocol) lets Claude, ChatGPT and Codex read your transactions, bank accounts, webhooks and SePay docs within the access you grant.

||

Claude, ChatGPT, Codex and other AI apps connect to SePay MCP at https://my.sepay.vn/mcp to read the SePay data you allow and look up integration docs. MCP (Model Context Protocol) is an open standard Anthropic published in November 2024 that lets AI apps use outside data and tools (modelcontextprotocol.io).

Claude builds a 2026 cash flow dashboard from SePay transaction data through SePay MCP
Click to expand
Claude reads transactions through SePay MCP and builds a cash flow dashboard.

What AI apps can read through SePay MCP

When you connect, you sign in to my.sepay.vn and choose which data the AI app may read:

  • Transactions and cash flow reports
  • Bank accounts and virtual accounts (VA)
  • Plan quota
  • Configured webhooks and webhook delivery history

SePay docs are readable right away, without signing in. SePay MCP: Read-only by default. Write actions run only when you grant access and confirm each one. It returns no account balance.

For example, you ask "Has order DH00012 been paid?" and the AI app finds the transaction with code DH00012, then answers with its time and amount. More sample questions are in SePay MCP tools.

Important

You choose which data the AI app reads and can hide sensitive information. Every read is in the activity log, and you can revoke a connection at any time.

Choose an AI app to connect

Claude and ChatGPT are chat apps you use in the browser. Claude Code and Codex run in the terminal, and Cursor is an AI code editor; these are mostly used for coding.

Requirements on SePay

Every connection starts from the AI Agent page on SePay: in the left menu, under Tích hợp & Thông báo, select AI Agent. SePay MCP is on for every company. A staff member with the Người dùng bình thường (regular user) role can connect only after a SuperAdmin or Admin grants them Cho phép kết nối AI qua MCP (allow AI connections through MCP) on the user permissions page, under Kết nối AI (MCP).

With no connection yet, the AI Agent page shows the Dùng AI với SePay (Use AI with SePay) screen. Click Tạo kết nối (Create connection) to open a full-screen app picker: Claude, Claude Code, ChatGPT, Codex, Cursor or Khác (Other). Once you have a connection, the page has 4 tabs: Tổng quan (Overview), Ứng dụng đã kết nối (Connected apps), Nhật ký hoạt động (Activity log) and Skills & CLI (details).

Connect other AI apps (VS Code, Gemini CLI, Cline...)

Cursor has its own guide at Connect Cursor to SePay via MCP. Any app that supports MCP servers over HTTP can connect. On the AI Agent page, select Tạo kết nối (Create connection) → Khác (Other), then Giao diện (GUI) for apps with a window or running on the web, or Dòng lệnh (CLI) for terminal tools. Connections made this way show as SePay MCP in the Ứng dụng đã kết nối tab; rename them to tell them apart.

Apps with a window

Tạo kết nối (Create connection) page, Khác (Other) card in GUI mode, with MCP Server URL, OAuth Client ID and the Callback URL field
Click to expand
GUI mode: copy MCP Server URL and OAuth Client ID, and save a Callback URL when the app needs one.
  1. In the AI app, open the place to add a remote MCP server. Name it sepay and paste MCP Server URL (https://my.sepay.vn/mcp). If you must pick a connection type, pick Streamable HTTP or HTTP.
  2. If the app asks for a Client ID, paste OAuth Client ID (sepay-mcp) and leave Client Secret empty.
  3. If the app runs on the web and shows a Callback URL (some call it Redirect URL), paste it into Callback URL on SePay and select Lưu Callback URL. Skip this step for apps that run on your computer.
  4. When the app opens the browser, sign in to SePay, pick the data groups and select Đồng ý cấp quyền (Grant access).

A Callback URL must start with https://. A saved address works only for your account, in the company currently selected: teammates save their own, and you save it again after switching company. Each account keeps up to 10 addresses; remove extras under Các URL đã lưu trước đó.

Sample setup from each vendor's docs:

VS Code (guide): open the Command Palette, run MCP: Add Server, choose HTTP (HTTP or Server-Sent Events), paste https://my.sepay.vn/mcp and set the ID to sepay. If VS Code asks for a Client ID, paste sepay-mcp.

Cline (guide): Configure tab → Configure MCP Servers → Remote Servers tab. Set Server Name to sepay, Server URL to https://my.sepay.vn/mcp, Transport Type to Streamable HTTP, then select Add Server.

Command-line tools

Tạo kết nối (Create connection) page, Khác (Other) card in CLI mode, with a Gemini CLI add command and a sample config file
Click to expand
CLI mode shows a Gemini CLI command to add SePay, a sample config file and the OAuth Client ID.

Command-line tools need no Callback URL and usually no Client ID; if a tool asks, paste OAuth Client ID. For example with Gemini CLI, add SePay to the current project folder with:

$ gemini mcp add --transport http sepay https://my.sepay.vn/mcp

Add -s user to use it in every project, or declare it in ~/.gemini/settings.json:

~/.gemini/settings.json
{
  "mcpServers": {
    "sepay": {
      "httpUrl": "https://my.sepay.vn/mcp"
    }
  }
}

To grant access, start Gemini CLI with gemini, type /mcp auth sepay and select Đồng ý cấp quyền in the browser. SePay returns to the tool after a few seconds. Remove SePay with gemini mcp remove sepay.

Common errors with other apps

Terms to know

TermMeaning
MCP serverThe address an AI app connects to, for SePay https://my.sepay.vn/mcp
ConnectorWhat Claude and ChatGPT call an added MCP server
Client IDThe code SePay issues to each AI app. It is public and needs no protection
Grant accessThe step where you sign in to SePay and choose the data the AI app may read
Connection sessionOne grant of one app in one place, for example Claude on your work computer
TerminalThe command window: Terminal on macOS, PowerShell on Windows

Manage connections

All connections are on the AI Agent page, which has 4 tabs: Tổng quan (Overview), Ứng dụng đã kết nối (Connected apps), Nhật ký hoạt động (Activity log) and Skills & CLI. A Người dùng bình thường (regular user) sees their own connections only. Everyone's Tổng quan tab shows connected apps, AI lookups in the last 30 days, last use, and recently connected apps with a Thu hồi (Revoke) button. SuperAdmin and Admin also see a company-wide monitoring block in the Tổng quan tab and can view other users' connections with the Đang xem (Viewing) filter. The Skills & CLI tab shows how to install SePay Skills and SePay CLI.

Overview tab of the AI Agent page on my.sepay.vn with connected apps, AI lookups in the last 30 days, last use and a table of recently connected apps
Click to expand
Overview tab: connected apps, AI lookups and recently used apps.

The Ứng dụng đã kết nối tab lists each connection with its access, grant date and last use. On each row:

  1. Select the pencil icon next to the name to give it a memorable name, for example "Cursor work laptop".
  2. Open the ⋮ menu to select Nhật ký (Log), Chỉnh quyền (Edit permissions) or Thu hồi (Revoke).
AI apps connected to SePay MCP on my.sepay.vn, with the actions menu open showing Log, Edit permissions, Revoke
Click to expand
Each connection has a rename button and a Log, Edit permissions, Revoke menu.

Chỉnh quyền turns each data group and hide option on or off; details in Edit permissions after connecting. Thu hồi ends the connection at once; details in Revoke connections.

Activity log

The Nhật ký hoạt động tab records each time an AI app reads data or resends a webhook: which connection, what action, when, from which IP, and whether it succeeded, failed or was denied. The log is kept for 90 days, including for revoked connections.

SePay MCP activity log on my.sepay.vn with period, app and status filters and a search box
Click to expand
The log records every SePay data read by an AI app, filterable by period, app and status.

Common errors when connecting SePay MCP

FAQ

Next steps