Twelve Data

Máy chủ MCP Twelve Data

Kết nối Claude, ChatGPT và các trợ lý AI khác với API tài chính Twelve Data — giá theo thời gian thực và lịch sử, hơn 60 chỉ báo kỹ thuật, dữ liệu cơ bản, thu nhập, cổ tức, ETF, tin tức công ty, cổ phiếu biến động mạnh, v.v.

Bạn cần có tài khoản Twelve Data. Đăng ký tại twelvedata.com.

Có hai cách sử dụng. Hầu hết mọi người nên dùng máy chủ đám mây (Tùy chọn 1) — không cần cài đặt gì cả.

---

Tùy chọn 1 — Sử dụng máy chủ đám mây của chúng tôi (khuyến nghị)

Kết nối trợ lý AI của bạn với máy chủ được lưu trữ của chúng tôi:

https://mcp.twelvedata.com/mcp

Vậy là xong. Không cần cài đặt, không cần sao chép và dán khóa API. Khi bạn kết nối, một cửa sổ trình duyệt sẽ mở ra và bạn đăng nhập bằng tài khoản Twelve Data của mình — khóa API cá nhân của bạn được liên kết tự động và gắn với tài khoản của bạn.

Cách thêm

Claude (Desktop / Web) và ChatGPT hỗ trợ trình kết nối tùy chỉnh / máy chủ MCP:

1. Mở cài đặt Trình kết nối (hoặc Tích hợp / Máy chủ MCP) của trợ lý.
2. Thêm trình kết nối mới với URL https://mcp.twelvedata.com/mcp.
3. Khi được nhắc, nhấp Kết nối / Đăng nhập — trang đăng nhập Twelve Data sẽ mở trong trình duyệt của bạn.
4. Ủy quyền và hoàn tất. Hãy hỏi những câu như "RSI của AAPL là bao nhiêu?" hoặc "Cho tôi xem thu nhập mới nhất của TSLA."

Tên menu chính xác khác nhau giữa các ứng dụng và phiên bản, nhưng quy trình luôn giống nhau: thêm URL, sau đó đăng nhập qua cửa sổ bật lên của trình duyệt.

Máy chủ MCP không phát hành mã thông báo. URL trình kết nối là https://mcp.twelvedata.com/mcp. Máy khách phải tuân theo siêu dữ liệu tài nguyên được bảo vệ của URL đó đến máy chủ ủy quyền được nêu ở đó. Không trỏ trình kết nối vào gốc máy chủ (nó trả về 404) hoặc vào /register hoặc /.well-known/oauth-authorization-server của máy chủ này.

Perplexity (trình kết nối từ xa tùy chỉnh)

Người dùng Perplexity Pro, Max và Enterprise có thể thêm máy chủ được lưu trữ dưới dạng trình kết nối từ xa tùy chỉnh. Đây là thiết lập theo tài khoản, không phải danh sách trong thư mục tuyển chọn công khai của Perplexity.

1. Trong Perplexity, mở Cài đặt tài khoản → Trình kết nối → + Trình kết nối tùy chỉnh và chọn Từ xa. Trên Enterprise, quản trị viên có thể cần cho phép trình kết nối tùy chỉnh trước.
2. Đặt Tên thành Twelve Data và URL máy chủ MCP thành https://mcp.twelvedata.com/mcp.
3. Chọn OAuth để xác thực và HTTP có thể truyền phát để truyền tải. Để trống Client ID và Client Secret để Perplexity có thể sử dụng đăng ký máy khách động trên máy chủ ủy quyền được nêu trong siêu dữ liệu tài nguyên được bảo vệ của máy chủ.
4. Chấp nhận xác nhận trình kết nối tùy chỉnh của Perplexity và nhấp Thêm. Sau đó nhấp vào thẻ trình kết nối Twelve Data để bắt đầu xác thực, đăng nhập vào tài khoản Twelve Data của bạn và ủy quyền truy cập.
5. Sau khi trình kết nối được bật, hãy thử các lời nhắc sau:
   • "Dùng Twelve Data để tìm mã chứng khoán AAPL."
   • "Dùng Twelve Data để lấy báo giá mới nhất cho AAPL, bao gồm giá và khối lượng."
   • "Dùng Twelve Data để hiển thị năm giá đóng cửa hàng ngày gần nhất của AAPL."
   • "Dùng Twelve Data để hiển thị RSI của AAPL."

Mỗi người đăng nhập bằng tài khoản Twelve Data của riêng họ. Nếu quản trị viên Enterprise chia sẻ trình kết nối, hãy yêu cầu xác thực riêng cho từng thành viên. Không dán khóa API Twelve Data vào trường xác thực Khóa API của trình kết nối.

Nếu cửa sổ OAuth bị chặn, đăng nhập thất bại hoặc các công cụ ngừng hoạt động sau thời gian chờ, hãy mở trình kết nối Twelve Data, tắt nó, bật lại và đăng nhập. Kết nối lại theo cách này thay vì chuyển trình kết nối sang xác thực Khóa API. Xác nhận URL chính xác là https://mcp.twelvedata.com/mcp không có dấu gạch chéo ở cuối và gói Twelve Data bao gồm dữ liệu được yêu cầu. Xem hướng dẫn trình kết nối từ xa tùy chỉnh của Perplexity để biết các màn hình cài đặt hiện tại.

Codex (CLI, máy tính để bàn và IDE)

Thêm máy chủ MCP được lưu trữ vào Codex mà không cần cài đặt kho lưu trữ này hoặc sao chép khóa API:

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

Lệnh add bắt đầu OAuth: hoàn tất đăng nhập Twelve Data trong trình duyệt của bạn. Nếu bạn cần ủy quyền lại sau đó, hãy chạy codex mcp login twelvedata. Trong Codex, sử dụng /mcp để kiểm tra kết nối, sau đó hỏi: "Dùng Twelve Data để lấy báo giá mới nhất cho AAPL." và "Dùng Twelve Data để hiển thị RSI của AAPL." Để ngắt kết nối, chạy codex mcp remove twelvedata.

Kho lưu trữ plugin công khai là https://github.com/MazeBraker/twelvedata-skills. Nó cài đặt các kỹ năng và cùng máy chủ MCP được lưu trữ:

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

---

Tùy chọn 2 — Tự chạy với khóa API

Muốn chạy máy chủ trên máy của riêng bạn? Bạn chỉ cần khóa API Twelve Data — không cần thiết lập OAuth. Lấy nó tại twelvedata.com → bảng điều khiển của bạn → Khóa API.

1. Cài đặt

Yêu cầu Python 3.10+ (khuyến nghị 3.12; trên macOS brew install python@3.12 hoặc make python-install).

make install

2. Thêm khóa API của bạn

Tạo tệp .env trong thư mục gốc dự án với khóa của bạn, chỉ bạn mới đọc được:

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

Máy chủ đọc khóa từ .env và mọi yêu cầu đều sử dụng nó. Không cần bước đăng nhập.

3. Kết nối qua stdio

Claude Desktop — thêm vào ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/mcp/.venv/bin/python",
      "args": ["/path/to/mcp/src/server.py"]
    }
  }
}

Sử dụng đường dẫn .venv/bin/python (không phải Python hệ thống — macOS đi kèm 3.9 và máy chủ này cần 3.10+). Khởi động lại Claude Desktop sau khi chỉnh sửa cấu hình.

Claude Code:

claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py

4. Kết nối qua HTTP

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. Chạy trong Docker

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file giữ khóa ngoài lịch sử shell của bạn. Kết nối đến http://localhost:8000/mcp như trong bước 4. Đăng nhập OAuth không được hỗ trợ trong Docker.

6. Bảo mật

• make run và Docker phục vụ /mcp không xác thực, trên 0.0.0.0 theo mặc định.
• Mọi cuộc gọi được phục vụ dưới thông tin xác thực của bạn.
• Bất kỳ ai truy cập được cổng đều có thể gọi auth_status và oauth_configure. Điều đó bao gồm một trang web bạn mở, thông qua DNS rebinding, vì liên kết mặc định không kiểm tra tiêu đề Host hoặc Origin.
• MCP_HOST=127.0.0.1 make run giữ máy chủ cục bộ và bật kiểm tra Host và Origin của SDK MCP.
• Với MCP_HOST=127.0.0.1, ngrok chỉ hoạt động khi được khởi động với --host-header=rewrite.

7. Khắc phục sự cố

Gọi auth_status từ máy khách của bạn trước. Nó hiển thị liệu khóa API đã được cấu hình chưa, mã thông báo được lưu trữ, máy chủ được phát hiện và URI chuyển hướng — thường đủ để biết điều gì còn thiếu.

---

Những gì bạn có thể hỏi

• Giá — cổ phiếu, ETF, ngoại hối, tiền điện tử (thời gian thực & lịch sử)
• Chỉ báo kỹ thuật — RSI, MACD, SMA, BBANDS, ATR và hơn 60 chỉ báo khác
• Dữ liệu cơ bản — báo cáo tài chính, thu nhập, cổ tức, chia tách, hồ sơ công ty, vốn hóa thị trường, số liệu chính, lịch IPO
• Quỹ — hồ sơ ETF & quỹ tương hỗ, hiệu suất, nắm giữ, rủi ro
• Tin tức — tin tức công ty & thông cáo báo chí
• Thông tin thị trường — cổ phiếu biến động mạnh, tỷ giá hối đoái, xếp hạng nhà phân tích, mục tiêu giá
• Quy định — hồ sơ SEC/EDGAR, giao dịch nội bộ, nắm giữ tổ chức

Định dạng mã chứng khoán: cổ phiếu AAPL, tiền điện tử BTC/USD, ngoại hối EUR/USD.

---

Đối tác

Đang chạy phiên bản công khai của riêng bạn hoặc thiết lập đăng nhập OAuth chuyên dụng? Đó là thỏa thuận đối tác — hãy liên hệ với chúng tôi tại twelvedata.com và chúng tôi sẽ cung cấp hướng dẫn thiết lập và thông tin xác thực OAuth.