Twelve Data

Twelve Data MCP Server

เชื่อมต่อ Claude, ChatGPT และผู้ช่วย AI อื่นๆ เข้ากับ Twelve Data financial API — ราคาแบบเรียลไทม์และย้อนหลัง, ตัวชี้วัดทางเทคนิคมากกว่า 60 รายการ, ข้อมูลพื้นฐาน, รายงานผลประกอบการ, เงินปันผล, ETF, ข่าวบริษัท, การเคลื่อนไหวของตลาด และอื่นๆ อีกมากมาย

คุณต้องมีบัญชี Twelve Data ลงทะเบียนได้ที่ twelvedata.com

มีสองวิธีในการใช้งาน คนส่วนใหญ่ควรใช้คลาวด์เซิร์ฟเวอร์ (ตัวเลือก 1) — ไม่ต้องติดตั้งอะไรเลย

---

ตัวเลือก 1 — ใช้คลาวด์เซิร์ฟเวอร์ของเรา (แนะนำ)

เชื่อมต่อผู้ช่วย AI ของคุณกับเซิร์ฟเวอร์ที่โฮสต์ของเรา:

https://mcp.twelvedata.com/mcp

แค่นั้นเอง ไม่ต้องติดตั้ง ไม่ต้องคัดลอกและวาง API key เมื่อคุณเชื่อมต่อ หน้าต่างเบราว์เซอร์จะเปิดขึ้นและคุณเข้าสู่ระบบด้วยบัญชี Twelve Data ของคุณ — API key ส่วนตัวของคุณจะเชื่อมโยงโดยอัตโนมัติและผูกกับบัญชีของคุณ

วิธีเพิ่ม

Claude (Desktop / Web) และ ChatGPT รองรับตัวเชื่อมต่อแบบกำหนดเอง / MCP servers:

1. เปิดการตั้งค่า Connectors (หรือ Integrations / MCP servers) ของผู้ช่วยของคุณ
2. เพิ่มตัวเชื่อมต่อใหม่ด้วย URL https://mcp.twelvedata.com/mcp
3. เมื่อได้รับแจ้ง คลิก Connect / Log in — หน้าเข้าสู่ระบบ Twelve Data จะเปิดในเบราว์เซอร์ของคุณ
4. อนุญาต และเสร็จสิ้น ถามคำถามเช่น "RSI ของ AAPL คือเท่าไร?" หรือ "แสดงผลประกอบการล่าสุดของ TSLA"

ชื่อเมนูที่แน่นอนอาจแตกต่างกันไปตามแอปและเวอร์ชัน แต่ขั้นตอนจะเหมือนเดิมเสมอ: เพิ่ม URL จากนั้นเข้าสู่ระบบผ่านป๊อปอัปของเบราว์เซอร์

MCP host ไม่ได้ออก token URL ของตัวเชื่อมต่อคือ https://mcp.twelvedata.com/mcp ไคลเอนต์ต้องปฏิบัติตาม metadata ของทรัพยากรที่ได้รับการป้องกันของ URL นั้นไปยังเซิร์ฟเวอร์อนุญาตที่ระบุไว้ที่นั่น อย่าชี้ตัวเชื่อมต่อไปที่ root ของ host (จะตอบกลับ 404) หรือไปที่ /register หรือ /.well-known/oauth-authorization-server ของ host นี้

Perplexity (ตัวเชื่อมต่อระยะไกลแบบกำหนดเอง)

ผู้ใช้ Perplexity Pro, Max และ Enterprise สามารถเพิ่มเซิร์ฟเวอร์ที่โฮสต์เป็นตัวเชื่อมต่อระยะไกลแบบกำหนดเองได้ นั่นคือการตั้งค่าต่อบัญชี ไม่ใช่การแสดงรายการในไดเรกทอรีที่คัดสรรสาธารณะของ Perplexity

1. ใน Perplexity เปิด Account settings → Connectors → + Custom connector และเลือก Remote สำหรับ Enterprise ผู้ดูแลระบบอาจต้องอนุญาตตัวเชื่อมต่อแบบกำหนดเองก่อน
2. ตั้งค่า Name เป็น Twelve Data และ MCP Server URL เป็น https://mcp.twelvedata.com/mcp
3. เลือก OAuth สำหรับการตรวจสอบสิทธิ์และ Streamable HTTP สำหรับการส่งข้อมูล เว้น Client ID และ Client Secret ว่างไว้เพื่อให้ Perplexity ใช้การลงทะเบียนไคลเอนต์แบบไดนามิกบนเซิร์ฟเวอร์อนุญาตที่ระบุใน metadata ของทรัพยากรที่ได้รับการป้องกันของเซิร์ฟเวอร์
4. ยอมรับการรับทราบตัวเชื่อมต่อแบบกำหนดเองของ Perplexity และคลิก Add จากนั้นคลิกการ์ดตัวเชื่อมต่อ Twelve Data เพื่อเริ่มการตรวจสอบสิทธิ์ ลงชื่อเข้าสู่บัญชี Twelve Data ของคุณ และอนุญาตการเข้าถึง
5. เมื่อเปิดใช้งานตัวเชื่อมต่อแล้ว ลองใช้พรอมต์เหล่านี้:
   • "Use Twelve Data to find the AAPL symbol."
   • "Use Twelve Data to get the latest quote for AAPL, including price and volume."
   • "Use Twelve Data to show the last five daily closing prices for AAPL."
   • "Use Twelve Data to show AAPL RSI."

แต่ละคนลงชื่อเข้าด้วยบัญชี Twelve Data ของตนเอง หากผู้ดูแลระบบ Enterprise แชร์ตัวเชื่อมต่อ ให้กำหนดให้มีการตรวจสอบสิทธิ์รายบุคคลสำหรับสมาชิกแต่ละคน อย่าวาง Twelve Data API key ลงในช่องการตรวจสอบสิทธิ์ API Key ของตัวเชื่อมต่อ

หากหน้าต่าง OAuth ถูกบล็อก การเข้าสู่ระบบล้มเหลว หรือเครื่องมือหยุดทำงานหลังจากไม่มีการใช้งาน ให้เปิดตัวเชื่อมต่อ Twelve Data ปิดการใช้งาน เปิดใช้งานอีกครั้ง และลงชื่อเข้าใช้ เชื่อมต่อใหม่ด้วยวิธีนี้แทนการเปลี่ยนตัวเชื่อมต่อเป็นการตรวจสอบสิทธิ์ API Key ยืนยันว่า URL คือ https://mcp.twelvedata.com/mcp ทุกประการโดยไม่มีเครื่องหมายทับท้าย และแผน Twelve Data รวมข้อมูลที่ร้องขอ ดู คู่มือตัวเชื่อมต่อระยะไกลแบบกำหนดเองของ Perplexity สำหรับหน้าจอการตั้งค่าปัจจุบัน

Codex (CLI, เดสก์ท็อป และ IDE)

เพิ่ม MCP เซิร์ฟเวอร์ที่โฮสต์ใน Codex โดยไม่ต้องติดตั้งพื้นที่เก็บข้อมูลนี้หรือคัดลอก API key:

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

คำสั่ง add เริ่ม OAuth: ทำการลงชื่อเข้าใช้ Twelve Data ในเบราว์เซอร์ของคุณให้เสร็จสมบูรณ์ หากคุณต้องการอนุญาตอีกครั้งในภายหลัง ให้รัน codex mcp login twelvedata ใน Codex ใช้ /mcp เพื่อตรวจสอบการเชื่อมต่อ จากนั้นถาม: "Use Twelve Data to get the latest quote for AAPL." และ "Use Twelve Data to show AAPL RSI." หากต้องการยกเลิกการเชื่อมต่อ ให้รัน codex mcp remove twelvedata

พื้นที่เก็บข้อมูลปลั๊กอินสาธารณะคือ https://github.com/MazeBraker/twelvedata-skills. ติดตั้งทักษะและ MCP ที่โฮสต์เดียวกัน:

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

---

ตัวเลือก 2 — รันด้วยตัวเองด้วย API key

ต้องการรันเซิร์ฟเวอร์บนเครื่องของคุณเองหรือไม่? คุณเพียงแค่ต้องมี Twelve Data API key — ไม่ต้องตั้งค่า OAuth รับได้ที่ twelvedata.com → แดชบอร์ดของคุณ → API Keys

1. ติดตั้ง

ต้องใช้ Python 3.10+ (แนะนำ 3.12; บน macOS brew install python@3.12 หรือ make python-install)

make install

2. เพิ่ม API key ของคุณ

สร้างไฟล์ .env ในโฟลเดอร์รากของโปรเจกต์ด้วยคีย์ของคุณ อ่านได้เฉพาะคุณเท่านั้น:

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

เซิร์ฟเวอร์อ่านคีย์จาก .env และทุกคำขอใช้คีย์นั้น ไม่ต้องมีขั้นตอนการเข้าสู่ระบบ

3. เชื่อมต่อผ่าน stdio

Claude Desktop — เพิ่มใน ~/Library/Application Support/Claude/claude_desktop_config.json:

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

ใช้พาธ .venv/bin/python (ไม่ใช่ Python ของระบบ — macOS มาพร้อม 3.9 และเซิร์ฟเวอร์นี้ต้องใช้ 3.10+) รีสตาร์ท Claude Desktop หลังจากแก้ไขการกำหนดค่า

Claude Code:

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

4. เชื่อมต่อผ่าน HTTP

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

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

5. รันใน Docker

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

--env-file เก็บคีย์ออกจากประวัติเชลล์ของคุณ เชื่อมต่อกับ http://localhost:8000/mcp เช่นเดียวกับขั้นตอนที่ 4 ไม่รองรับการเข้าสู่ระบบ OAuth ใน Docker

6. ความปลอดภัย

• make run และ Docker ให้บริการ /mcp โดยไม่มีการตรวจสอบสิทธิ์ บน 0.0.0.0 โดยค่าเริ่มต้น
• ทุกการเรียกใช้บริการภายใต้ข้อมูลประจำตัว ของคุณ
• ใครก็ตามที่เข้าถึงพอร์ตได้สามารถเรียก auth_status และ oauth_configure ซึ่งรวมถึงหน้าเว็บที่คุณเปิด ผ่าน DNS rebinding เนื่องจากการผูกค่าเริ่มต้นไม่ได้ตรวจสอบทั้ง Host หรือ Origin header
• MCP_HOST=127.0.0.1 make run ทำให้เซิร์ฟเวอร์อยู่ในเครื่องและเปิดใช้งานการตรวจสอบ Host และ Origin ของ MCP SDK
• ด้วย MCP_HOST=127.0.0.1 ngrok ทำงานได้เฉพาะเมื่อเริ่มต้นด้วย --host-header=rewrite

7. การแก้ไขปัญหา

เรียก auth_status จากไคลเอนต์ของคุณก่อน โดยจะแสดงว่ามีการกำหนดค่า API key หรือไม่ token ที่เก็บไว้ host ที่ตรวจพบ และ redirect URI — โดยปกติเพียงพอที่จะเห็นสิ่งที่ขาดหายไป

---

สิ่งที่คุณสามารถถามได้

• ราคา — หุ้น, ETF, ฟอเร็กซ์, คริปโต, สินค้าโภคภัณฑ์ (เรียลไทม์และย้อนหลัง)
• ตัวชี้วัดทางเทคนิค — RSI, MACD, SMA, BBANDS, ATR และอีกมากกว่า 60 รายการ
• ข้อมูลพื้นฐาน — งบการเงิน, ผลประกอบการ, เงินปันผล, การแยกหุ้น, โปรไฟล์บริษัท, มูลค่าตลาด, สถิติสำคัญ, ปฏิทิน IPO
• กองทุน — โปรไฟล์ ETF และกองทุนรวม, ผลการดำเนินงาน, การถือครอง, ความเสี่ยง
• ข่าว — ข่าวบริษัทและข่าวประชาสัมพันธ์
• ข้อมูลเชิงลึกของตลาด — การเคลื่อนไหว, อัตราแลกเปลี่ยน, การจัดอันดับนักวิเคราะห์, ราคาเป้าหมาย
• กฎระเบียบ — การยื่น SEC/EDGAR, ธุรกรรม insider, การถือครองของสถาบัน

รูปแบบสัญลักษณ์: หุ้น AAPL, คริปโต BTC/USD, ฟอเร็กซ์ EUR/USD

---

พาร์ทเนอร์

กำลังรันอินสแตนซ์สาธารณะของคุณเองหรือตั้งค่า OAuth login เฉพาะหรือไม่? นั่นคือการจัดเตรียมแบบพาร์ทเนอร์ — ติดต่อเราได้ที่ twelvedata.com แล้วเราจะให้คู่มือการตั้งค่าและข้อมูลรับรอง OAuth