ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิวได้แล้วต้นแบบ · อัปเดตทุก 30 นาที
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · วิธีติดตั้งภาษาไทยทุกตัว

MCP Reportia

โดย javalenciacaiรุ่น 0.3.2i★ 0iรันบนเครื่องหน้า repo ↗
ชื่อใน registryio.github.javalenciacai/mcp-reportia

วิธีติดตั้ง

ใช้ทำอะไรได้

ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ

  • ต่อแบบ ติดตั้งในเครื่อง
  • บัญชีหรือคีย์ ต้องมี REPORTIA_TOKEN, REPORTIA_COOKIE, REPORTIA_PASSWORD · ต้องกรอกค่าตั้ง 1 ช่อง (REPORTIA_BASE_URL)
  • หมวด บัญชี การเงิน และภาษี
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Reportia HTTP API as 66 curated MCP tools (accounting, mappings, SIIGO).

ทำไมอยู่อันดับนี้

หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้

ความนิยม0/80ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20
ความสด12/12ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม
ระบบยังตอบ0/8endpoint บนคลาวด์ตอบตอนตรวจล่าสุด
คะแนนการใช้งาน12/100

คุณภาพ: ผลตรวจเบื้องต้นผ่าน 3/3 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ให้ AI ติดตั้งให้ด้วยประโยคเดียว

ติดตั้ง MCP Reportia ให้หน่อย ทำตาม https://mcp.popnx.com/i/javalenciacai-mcp-reportia.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรัน

คัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน

ผลตรวจผ่าน 3/3 · ทำงานบนเครื่องคุณ · ✓ ตรวจคำสั่งแล้ว 14 พ.ย. 2569

ขั้นแรก: คุณใช้ AI ตัวไหน

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ MCP Reportia (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (REPORTIA_BASE_URL) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ

ให้ AI ติดตั้งให้

คัดลอกข้อความนี้ไปวางในแชตของ Claude AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง

ช่วยติดตั้ง MCP server ชื่อ MCP Reportia ให้ Claude ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี Node.js ด้วยคำสั่ง node -v ถ้าไม่มี ให้บอกฉันไปลงจาก https://nodejs.org/en/download ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "mcpServers": { "reportia": { "command": "npx", "args": [ "-y", "@james.valencia/mcp-reportia" ], "env": { "REPORTIA_BASE_URL": "ใส่ค่าของคุณ", "REPORTIA_TOKEN": "ใส่ค่าของคุณ", "REPORTIA_COOKIE": "ใส่ค่าของคุณ", "REPORTIA_PASSWORD": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง REPORTIA_TOKEN, REPORTIA_COOKIE, REPORTIA_PASSWORD, REPORTIA_BASE_URL ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ MCP Reportia ขึ้นจริง

ข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป

  1. ลง Node.js ในเครื่อง (ถ้ายังไม่มี)

    ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter

    node -v
    • ขึ้นเลขรุ่น เช่น v26.13.1 = ลงแล้ว ข้ามขั้นนี้ได้
    • ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
    เปิด Terminal ยังไง

    Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter

    Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open

    ยังไม่ได้ลง: เปิดหน้าดาวน์โหลดทางการ เลือกรุ่น LTS แล้วเลือกตัวติดตั้งแบบกดเอง: Mac ไฟล์ .pkg · Windows ไฟล์ .msi ดับเบิลคลิกแล้วกดถัดไปจนจบ ไม่ต้องใช้คำสั่ง curl

    เปิดหน้าดาวน์โหลด Node.js ↗

    ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: node -v

    ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Node.js

  2. สมัครและสร้างคีย์ของ MCP Reportia

    เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ

    วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง

  3. กรอกค่าตั้ง 1 ช่อง

    ค่าเหล่านี้เป็นค่าตั้งของโปรแกรม ไม่ใช่คีย์ ไม่ต้องสมัครอะไร ใส่ตามที่ผู้ทำอธิบาย

    • REPORTIA_BASE_URL Base URL of the Reportia API (without trailing slash). Example: https://reportia.example.com

    คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ

  4. เปิดไฟล์ตั้งค่าของแอป Claude บนคอม

    SettingsDeveloperEdit Config

  5. วางค่าตั้งนี้แล้วบันทึกไฟล์

    {
      "mcpServers": {
        "reportia": {
          "command": "npx",
          "args": [
            "-y",
            "@james.valencia/mcp-reportia"
          ],
          "env": {
            "REPORTIA_BASE_URL": "ใส่ค่าของคุณ",
            "REPORTIA_TOKEN": "ใส่ค่าของคุณ",
            "REPORTIA_COOKIE": "ใส่ค่าของคุณ",
            "REPORTIA_PASSWORD": "ใส่ค่าของคุณ"
          }
        }
      }
    }

    วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร

  6. ปิดแอป Claude แล้วเปิดใหม่

  7. ลองเลย

    ใช้ MCP Reportia บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude บอกว่ากำลังใช้ MCP Reportia หรือมีชื่อเครื่องมือของ MCP Reportia ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ค่าตั้งเพิ่มเติม 6 ช่อง (ไม่ต้องกรอกก็ใช้ได้)

คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ

  • REPORTIA_EMAIL Email for cookie-session authentication.
  • REPORTIA_COMPANY_ID Default companyId used when a tool accepts it as optional.
  • REPORTIA_TIMEOUT_MS HTTP request timeout in milliseconds (default 30000).
  • REPORTIA_DOWNLOAD_DIR Directory where downloaded Excel/PDF exports are saved (default ./downloads).
  • REPORTIA_USER_AGENT Custom User-Agent header (default mcp-reportia/0.1.0).
  • REPORTIA_MAX_DOWNLOAD_BYTES จำนวนไบต์สูงสุดสำหรับการดาวน์โหลดไบนารีแต่ละครั้ง (ค่าเริ่มต้น 104857600 = 100MB)
    ดูต้นฉบับภาษาอังกฤษMaximum bytes for a single binary download (default 104857600 = 100MB).

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ChatGPT ยังต่อ MCP Reportia ไม่ได้

MCP Reportia ต้องติดตั้งในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะตัวที่ทำงานบนเว็บ

คุณทำแบบนี้แทนได้

ก · ใช้แอปที่ต่อ MCP Reportia ได้

  • ต้องมีคีย์ของ MCP Reportia (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (REPORTIA_BASE_URL) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
  • ต้องมีคีย์ของ MCP Reportia (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (REPORTIA_BASE_URL) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)
  • ต้องมีคีย์ของ MCP Reportia (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (REPORTIA_BASE_URL) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)
  • ต้องมีคีย์ของ MCP Reportia (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (REPORTIA_BASE_URL) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)

ข · ตัวอื่นในหมวด บัญชี การเงิน และภาษี ที่ต่อกับ ChatGPT ได้

เลือกจากตัวที่ใช้มากในหมวดเดียวกัน เฉพาะตัวที่ต่อด้วยที่อยู่ได้โดยไม่ต้องใส่คีย์

ต่อกับ Claude Code ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ MCP Reportia (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (REPORTIA_BASE_URL) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)

ให้ AI ติดตั้งให้

คัดลอกข้อความนี้ไปวางในแชตของ Claude Code AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง

ช่วยติดตั้ง MCP server ชื่อ MCP Reportia ให้ Claude Code ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี Node.js ด้วยคำสั่ง node -v ถ้าไม่มี ให้บอกฉันไปลงจาก https://nodejs.org/en/download ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): claude mcp add --scope user reportia --env REPORTIA_BASE_URL='ใส่ค่าของคุณ' --env REPORTIA_TOKEN='ใส่ค่าของคุณ' --env REPORTIA_COOKIE='ใส่ค่าของคุณ' --env REPORTIA_PASSWORD='ใส่ค่าของคุณ' -- npx -y @james.valencia/mcp-reportia 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง REPORTIA_TOKEN, REPORTIA_COOKIE, REPORTIA_PASSWORD, REPORTIA_BASE_URL ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ MCP Reportia ขึ้นจริง

ข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป

  1. ลง Node.js ในเครื่อง (ถ้ายังไม่มี)

    ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter

    node -v
    • ขึ้นเลขรุ่น เช่น v26.13.1 = ลงแล้ว ข้ามขั้นนี้ได้
    • ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
    เปิด Terminal ยังไง

    Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter

    Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open

    ยังไม่ได้ลง: เปิดหน้าดาวน์โหลดทางการ เลือกรุ่น LTS แล้วเลือกตัวติดตั้งแบบกดเอง: Mac ไฟล์ .pkg · Windows ไฟล์ .msi ดับเบิลคลิกแล้วกดถัดไปจนจบ ไม่ต้องใช้คำสั่ง curl

    เปิดหน้าดาวน์โหลด Node.js ↗

    ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: node -v

    ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Node.js

  2. สมัครและสร้างคีย์ของ MCP Reportia

    เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ

    วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง

  3. กรอกค่าตั้ง 1 ช่อง

    ค่าเหล่านี้เป็นค่าตั้งของโปรแกรม ไม่ใช่คีย์ ไม่ต้องสมัครอะไร ใส่ตามที่ผู้ทำอธิบาย

    • REPORTIA_BASE_URL Base URL of the Reportia API (without trailing slash). Example: https://reportia.example.com

    คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ

  4. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell

  5. วางคำสั่งนี้แล้วกด Enter

    claude mcp add --scope user reportia --env REPORTIA_BASE_URL='ใส่ค่าของคุณ' --env REPORTIA_TOKEN='ใส่ค่าของคุณ' --env REPORTIA_COOKIE='ใส่ค่าของคุณ' --env REPORTIA_PASSWORD='ใส่ค่าของคุณ' -- npx -y @james.valencia/mcp-reportia

    แก้ “ใส่ค่าของคุณ” เป็นคีย์ของคุณก่อนกด Enter

    วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร

  6. พิมพ์ /mcp ใน Claude Code

    ต้องเห็น MCP Reportia ในรายการและขึ้นว่าเชื่อมต่อแล้ว

  7. ลองเลย

    ใช้ MCP Reportia บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude Code บอกว่ากำลังใช้ MCP Reportia หรือมีชื่อเครื่องมือของ MCP Reportia ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ค่าตั้งเพิ่มเติม 6 ช่อง (ไม่ต้องกรอกก็ใช้ได้)

คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ

  • REPORTIA_EMAIL Email for cookie-session authentication.
  • REPORTIA_COMPANY_ID Default companyId used when a tool accepts it as optional.
  • REPORTIA_TIMEOUT_MS HTTP request timeout in milliseconds (default 30000).
  • REPORTIA_DOWNLOAD_DIR Directory where downloaded Excel/PDF exports are saved (default ./downloads).
  • REPORTIA_USER_AGENT Custom User-Agent header (default mcp-reportia/0.1.0).
  • REPORTIA_MAX_DOWNLOAD_BYTES จำนวนไบต์สูงสุดสำหรับการดาวน์โหลดไบนารีแต่ละครั้ง (ค่าเริ่มต้น 104857600 = 100MB)
    ดูต้นฉบับภาษาอังกฤษMaximum bytes for a single binary download (default 104857600 = 100MB).

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Cursor ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ MCP Reportia (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (REPORTIA_BASE_URL) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)

ให้ AI ติดตั้งให้

คัดลอกข้อความนี้ไปวางในแชตของ Cursor AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง

ช่วยติดตั้ง MCP server ชื่อ MCP Reportia ให้ Cursor ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี Node.js ด้วยคำสั่ง node -v ถ้าไม่มี ให้บอกฉันไปลงจาก https://nodejs.org/en/download ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "mcpServers": { "reportia": { "command": "npx", "args": [ "-y", "@james.valencia/mcp-reportia" ], "env": { "REPORTIA_BASE_URL": "ใส่ค่าของคุณ", "REPORTIA_TOKEN": "ใส่ค่าของคุณ", "REPORTIA_COOKIE": "ใส่ค่าของคุณ", "REPORTIA_PASSWORD": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง REPORTIA_TOKEN, REPORTIA_COOKIE, REPORTIA_PASSWORD, REPORTIA_BASE_URL ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ MCP Reportia ขึ้นจริง

ข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป

  1. ลง Node.js ในเครื่อง (ถ้ายังไม่มี)

    ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter

    node -v
    • ขึ้นเลขรุ่น เช่น v26.13.1 = ลงแล้ว ข้ามขั้นนี้ได้
    • ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
    เปิด Terminal ยังไง

    Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter

    Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open

    ยังไม่ได้ลง: เปิดหน้าดาวน์โหลดทางการ เลือกรุ่น LTS แล้วเลือกตัวติดตั้งแบบกดเอง: Mac ไฟล์ .pkg · Windows ไฟล์ .msi ดับเบิลคลิกแล้วกดถัดไปจนจบ ไม่ต้องใช้คำสั่ง curl

    เปิดหน้าดาวน์โหลด Node.js ↗

    ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: node -v

    ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Node.js

  2. สมัครและสร้างคีย์ของ MCP Reportia

    เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ

    วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง

  3. กรอกค่าตั้ง 1 ช่อง

    ค่าเหล่านี้เป็นค่าตั้งของโปรแกรม ไม่ใช่คีย์ ไม่ต้องสมัครอะไร ใส่ตามที่ผู้ทำอธิบาย

    • REPORTIA_BASE_URL Base URL of the Reportia API (without trailing slash). Example: https://reportia.example.com

    คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ

  4. กดปุ่มนี้เพื่อเปิด Cursor

    เปิดใน Cursor

    Cursor จะถามยืนยันการติดตั้ง ให้กด Install

  5. ใส่คีย์ในช่องที่ว่างไว้

    ในค่าตั้งของ MCP Reportia ช่อง REPORTIA_TOKEN, REPORTIA_COOKIE, REPORTIA_PASSWORD, REPORTIA_BASE_URL ยังว่าง ใส่คีย์ของคุณแล้วบันทึก

    วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร

  6. เปิดแชตของ AI ใน Cursor โหมด Agent

  7. ลองเลย

    ใช้ MCP Reportia บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Cursor บอกว่ากำลังใช้ MCP Reportia หรือมีชื่อเครื่องมือของ MCP Reportia ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ค่าตั้งเพิ่มเติม 6 ช่อง (ไม่ต้องกรอกก็ใช้ได้)

คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ

  • REPORTIA_EMAIL Email for cookie-session authentication.
  • REPORTIA_COMPANY_ID Default companyId used when a tool accepts it as optional.
  • REPORTIA_TIMEOUT_MS HTTP request timeout in milliseconds (default 30000).
  • REPORTIA_DOWNLOAD_DIR Directory where downloaded Excel/PDF exports are saved (default ./downloads).
  • REPORTIA_USER_AGENT Custom User-Agent header (default mcp-reportia/0.1.0).
  • REPORTIA_MAX_DOWNLOAD_BYTES จำนวนไบต์สูงสุดสำหรับการดาวน์โหลดไบนารีแต่ละครั้ง (ค่าเริ่มต้น 104857600 = 100MB)
    ดูต้นฉบับภาษาอังกฤษMaximum bytes for a single binary download (default 104857600 = 100MB).

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ VS Code ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ MCP Reportia (สร้างที่เว็บของผู้ทำ) · ต้องกรอกค่าตั้ง 1 ช่อง (REPORTIA_BASE_URL) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)

ให้ AI ติดตั้งให้

คัดลอกข้อความนี้ไปวางในแชตของ VS Code AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง

ช่วยติดตั้ง MCP server ชื่อ MCP Reportia ให้ VS Code ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี Node.js ด้วยคำสั่ง node -v ถ้าไม่มี ให้บอกฉันไปลงจาก https://nodejs.org/en/download ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "servers": { "reportia": { "type": "stdio", "command": "npx", "args": [ "-y", "@james.valencia/mcp-reportia" ], "env": { "REPORTIA_BASE_URL": "ใส่ค่าของคุณ", "REPORTIA_TOKEN": "ใส่ค่าของคุณ", "REPORTIA_COOKIE": "ใส่ค่าของคุณ", "REPORTIA_PASSWORD": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง REPORTIA_TOKEN, REPORTIA_COOKIE, REPORTIA_PASSWORD, REPORTIA_BASE_URL ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ MCP Reportia ขึ้นจริง

ข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป

  1. ลง Node.js ในเครื่อง (ถ้ายังไม่มี)

    ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter

    node -v
    • ขึ้นเลขรุ่น เช่น v26.13.1 = ลงแล้ว ข้ามขั้นนี้ได้
    • ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
    เปิด Terminal ยังไง

    Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter

    Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open

    ยังไม่ได้ลง: เปิดหน้าดาวน์โหลดทางการ เลือกรุ่น LTS แล้วเลือกตัวติดตั้งแบบกดเอง: Mac ไฟล์ .pkg · Windows ไฟล์ .msi ดับเบิลคลิกแล้วกดถัดไปจนจบ ไม่ต้องใช้คำสั่ง curl

    เปิดหน้าดาวน์โหลด Node.js ↗

    ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น: node -v

    ลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Node.js

  2. สมัครและสร้างคีย์ของ MCP Reportia

    เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ

    วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง

  3. กรอกค่าตั้ง 1 ช่อง

    ค่าเหล่านี้เป็นค่าตั้งของโปรแกรม ไม่ใช่คีย์ ไม่ต้องสมัครอะไร ใส่ตามที่ผู้ทำอธิบาย

    • REPORTIA_BASE_URL Base URL of the Reportia API (without trailing slash). Example: https://reportia.example.com

    คำอธิบายยังเป็นภาษาอังกฤษตามต้นฉบับ

  4. กดปุ่มนี้เพื่อเปิด VS Code

    เปิดใน VS Code

    VS Code จะถามยืนยันการติดตั้ง ให้กด Install

  5. ใส่คีย์ในช่องที่ว่างไว้

    ในค่าตั้งของ MCP Reportia ช่อง REPORTIA_TOKEN, REPORTIA_COOKIE, REPORTIA_PASSWORD, REPORTIA_BASE_URL ยังว่าง ใส่คีย์ของคุณแล้วบันทึก

    วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร

  6. เปิดแชตของ AI ใน VS Code โหมด Agent

  7. ลองเลย

    ใช้ MCP Reportia บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า VS Code บอกว่ากำลังใช้ MCP Reportia หรือมีชื่อเครื่องมือของ MCP Reportia ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ค่าตั้งเพิ่มเติม 6 ช่อง (ไม่ต้องกรอกก็ใช้ได้)

คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ

  • REPORTIA_EMAIL Email for cookie-session authentication.
  • REPORTIA_COMPANY_ID Default companyId used when a tool accepts it as optional.
  • REPORTIA_TIMEOUT_MS HTTP request timeout in milliseconds (default 30000).
  • REPORTIA_DOWNLOAD_DIR Directory where downloaded Excel/PDF exports are saved (default ./downloads).
  • REPORTIA_USER_AGENT Custom User-Agent header (default mcp-reportia/0.1.0).
  • REPORTIA_MAX_DOWNLOAD_BYTES จำนวนไบต์สูงสุดสำหรับการดาวน์โหลดไบนารีแต่ละครั้ง (ค่าเริ่มต้น 104857600 = 100MB)
    ดูต้นฉบับภาษาอังกฤษMaximum bytes for a single binary download (default 104857600 = 100MB).

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ MCP Reportia อยู่💬 พูดคุย →
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON

ติดตั้งในเครื่อง

Claude Code

claude mcp add --scope user reportia --env REPORTIA_BASE_URL='ใส่ค่าของคุณ' --env REPORTIA_TOKEN='ใส่ค่าของคุณ' --env REPORTIA_COOKIE='ใส่ค่าของคุณ' --env REPORTIA_PASSWORD='ใส่ค่าของคุณ' -- npx -y @james.valencia/mcp-reportia

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "reportia": {
      "command": "npx",
      "args": [
        "-y",
        "@james.valencia/mcp-reportia"
      ],
      "env": {
        "REPORTIA_BASE_URL": "ใส่ค่าของคุณ",
        "REPORTIA_TOKEN": "ใส่ค่าของคุณ",
        "REPORTIA_COOKIE": "ใส่ค่าของคุณ",
        "REPORTIA_PASSWORD": "ใส่ค่าของคุณ"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "reportia": {
      "command": "npx",
      "args": [
        "-y",
        "@james.valencia/mcp-reportia"
      ],
      "env": {
        "REPORTIA_BASE_URL": "ใส่ค่าของคุณ",
        "REPORTIA_TOKEN": "ใส่ค่าของคุณ",
        "REPORTIA_COOKIE": "ใส่ค่าของคุณ",
        "REPORTIA_PASSWORD": "ใส่ค่าของคุณ"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "reportia": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@james.valencia/mcp-reportia"
      ],
      "env": {
        "REPORTIA_BASE_URL": "ใส่ค่าของคุณ",
        "REPORTIA_TOKEN": "ใส่ค่าของคุณ",
        "REPORTIA_COOKIE": "ใส่ค่าของคุณ",
        "REPORTIA_PASSWORD": "ใส่ค่าของคุณ"
      }
    }
  }
}

ค่าที่ต้องใส่เอง

  • REPORTIA_BASE_URL จำเป็น env
    Base URL of the Reportia API (without trailing slash). Example: https://reportia.example.com
  • REPORTIA_TOKEN ความลับ จำเป็น env
    Bearer token for M2M authentication. Mutually exclusive with REPORTIA_COOKIE; either can be paired with REPORTIA_EMAIL+REPORTIA_PASSWORD (session login) for cookie fallback.
  • REPORTIA_COOKIE ความลับ จำเป็น env
    Pre-issued Reportia session cookie (e.g. connect.sid=s%3A...). For upstream callers that already hold the resolved user's session and want the child to authenticate as that user without re-login. Mut…
  • REPORTIA_EMAIL env
    Email for cookie-session authentication.
  • REPORTIA_PASSWORD ความลับ จำเป็น env
    รหัสผ่านสำหรับการยืนยันตัวตนแบบ cookie-session
    ดูต้นฉบับภาษาอังกฤษPassword for cookie-session authentication.
  • REPORTIA_COMPANY_ID env
    Default companyId used when a tool accepts it as optional.
  • REPORTIA_TIMEOUT_MS env
    HTTP request timeout in milliseconds (default 30000).
  • REPORTIA_DOWNLOAD_DIR env
    Directory where downloaded Excel/PDF exports are saved (default ./downloads).
  • REPORTIA_USER_AGENT env
    Custom User-Agent header (default mcp-reportia/0.1.0).
  • REPORTIA_MAX_DOWNLOAD_BYTES env
    จำนวนไบต์สูงสุดสำหรับการดาวน์โหลดไบนารีแต่ละครั้ง (ค่าเริ่มต้น 104857600 = 100MB)
    ดูต้นฉบับภาษาอังกฤษMaximum bytes for a single binary download (default 104857600 = 100MB).

คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

สรุป

ดาวน์โหลดต่อสัปดาห์i
48/สัปดาห์
การเชื่อมต่อ
รันบนเครื่อง
รุ่นล่าสุดi
0.3.2
ส่งเข้า registryi
11 ก.ย. 2569
แก้โค้ดล่าสุดi
23 ต.ค. 2569
ผู้ทำ
javalenciacai
แพ็กเกจ
npm: @james.valencia/mcp-reportia
สถานะใน registry
ใช้งานอยู่

ใช้กับโปรแกรมไหนได้

ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569

ติดตั้งบนเครื่องได้ใน

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

ดูโปรแกรมทั้งหมดพร้อมข้อดีข้อเสีย →

คู่มือที่เกี่ยวข้อง

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 18 พ.ย. 2569

  • ✓ ผ่าน

    ตัวตนผู้ทำตรงกับ repo

    ชื่อใน registry ยืนยันด้วยบัญชี GitHub javalenciacai ซึ่งเป็นเจ้าของ repo

  • ✓ ผ่าน

    ยังมีคนดูแล

    มีการแก้โค้ดล่าสุด 26 วันที่ผ่านมา

  • ✓ ผ่าน

    มีสัญญาอนุญาต (license)

    ใช้ MIT

  • – ไม่เกี่ยว

    endpoint ตอบ

    ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต

  • – ไม่เกี่ยว

    ล็อกอินแบบ OAuth

    ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน

  • … ยังไม่ตรวจ

    คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

    รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

ช่องโหว่ที่เปิดเผยแล้ว (OSV.dev)

ไม่พบรายการใน OSV.dev สำหรับ @james.valencia/mcp-reportia@0.3.2

ตรวจเฉพาะตัวแพ็กเกจรุ่นนี้ ไม่ใช่ทุก dependency · ตรวจเมื่อ 15 พ.ย. 2569

เราตรวจอะไรบ้าง → · JSON

ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README

ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้

[![แนะนำบน PopNx MCP](https://mcp.popnx.com/badge/javalenciacai-mcp-reportia.svg?lang=th)](https://mcp.popnx.com/th/servers/javalenciacai-mcp-reportia)

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบเพื่อโพสต์

รีวิวจากผู้ใช้

ยังไม่มีรีวิว

เข้าสู่ระบบเพื่อเขียนรีวิว

เทียบกับตัวอื่นในหมวด บัญชี การเงิน และภาษีi

  • ดาวมากกว่า 0% ของอีก 3397 ตัวในหมวดนี้
  • ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 30% ของอีก 3397 ตัวในหมวดนี้
  • ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 3397 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

MCP Reportia ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 3 จาก 3 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: REPORTIA_TOKEN, REPORTIA_COOKIE, REPORTIA_PASSWORD

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด 26 วันที่ผ่านมา และส่งรุ่นล่าสุด (0.3.2) เข้า registry 2 เดือนที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

ตัวอื่นที่ทำงานคล้ายกัน

หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

โดย SolidInvoiceกำลังโต★ 989อัปเดต 9 วันที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · solidinvoice.co

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

โดย signal8aiกำลังโต↓ 431/สัปดาห์★ 425อัปเดต 9 วันที่ผ่านมา

บนเครื่องหรือคลาวด์✓ เจ้าของบริการ · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

โดย Cursivezกำลังโต★ 260อัปเดต 10 วันที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

โดย bex-coกำลังโต★ 688 ดาวรวมทั้งรีโปอัปเดต 43 วันที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · beancount.io

Tapetide - Indian Stock Market MCP

48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options

โดย Tapetide-hqกำลังโต↓ 184/สัปดาห์★ 151อัปเดต 21 วันที่ผ่านมา

บนเครื่องหรือคลาวด์✓ เจ้าของบริการ · tapetide.com
เทียบกับตัวที่คล้ายกัน
ตัวนี้
MCP Reportia
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
ทำงานที่ไหนต้องลงในเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องมีทั้งบนคลาวด์และแบบลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องมีทั้งบนคลาวด์และแบบลงเครื่อง
ต้องใส่คีย์ใช่ไม่ใช่ไม่ไม่ใช่
กด + ใน Claude ได้ไม่ไม่ไม่ไม่ไม่ไม่
ผลตรวจเบื้องต้น3/34/65/54/44/45/5
สัญญาอนุญาตMITMITMITNOASSERTIONMITMIT
ราคาไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียน

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

mcp-reportia

Servidor [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) independiente que envuelve la API HTTP real de Reportia y la expone a través del transporte stdio con JSON-RPC newline-delimited. Pensado para ser consumido por clientes MCP (Claude Desktop, Cursor, Hermes Agent, otros) con un único npx, sin ejecutar código de servidor propio.

Esta capa no contiene lógica de negocio ni secretos propios: actúa como traductor entre el protocolo MCP y los endpoints REST de Reportia. Las credenciales se inyectan desde variables de entorno.


Índice

  • Dónde está indexado
  • Instalación y uso rápido
  • Variables de entorno
  • Configuración en clientes MCP
  • Flujo de release
  • Herramientas disponibles
  • Limitaciones conocidas
  • Seguridad
  • Rutas cubiertas y omitidas
  • Desarrollo local
  • Pruebas
  • Inspección con MCP Inspector
  • Arquitectura interna
  • Licencia

Dónde está indexado

Este servidor MCP está publicado y discoverable en:

PlataformaURLFormato
MCP Registry oficial (modelcontextprotocol.io)io.github.javalenciacai/mcp-reportiaserver.json
npm registry@james.valencia/mcp-reportianpm package
skills.sh (Agent Skills Directory)javalenciacai/mcp-reportiaskills/reportia-mcp-usage/SKILL.md

Instalación via skills.sh:

npx skills add javalenciacai/mcp-reportia --skill reportia-mcp-usage

Flujo de release

Este repo publica automáticamente a npm y al MCP Registry oficial cuando se pushea un tag v* a main. La indexación en skills.sh es automática (scrapeo de GitHub).

Configuración inicial (una sola vez)
Opción elegida: npm Trusted Publishing (OIDC)

La configuración vive en la página del paquete (no en /settings/james.valencia/security — esa URL es para tokens tradicionales).

  1. Abre https://www.npmjs.com/package/@james.valencia/mcp-reportia/settings (logueado como james.valencia en el navegador).
  2. En la sección "Trusted Publisher", click en "Add a trusted publisher" (o "GitHub Actions" según el wording de tu versión de npmjs.com).
  3. Completa el formulario con estos valores exactos (la doc oficial los lista así):
CampoValor
ProviderGitHub Actions
Organization or userjavalenciacai
Repositorymcp-reportia
Workflow filenamepublish.yml (solo el nombre, sin la ruta .github/workflows/)
Environment name(vacío) — el workflow no usa GitHub Environments
Allowed actionsnpm publish (al menos uno)
  1. Click "Add" o "Save". npm NO valida la configuración al guardar, pero el workflow fallará en runtime si los datos no coinciden exactamente.
Subir el workflow a Node 24 (necesario para Trusted Publishing)

Trusted Publishing requiere npm >= 11.5.1, que viene incluido en Node.js 24. El workflow actual usa Node 22 (npm 10.9) — fallará con ENEEDAUTH aunque el publisher esté bien configurado.

Lo que voy a hacer yo cuando confirmes el paso 1: actualizar el workflow a Node 24, hacer commit, re-crear el tag v0.1.2 apuntando al nuevo commit, re-disparar el publish.

Verificación rápida de que está bien

Re-dispara manualmente el workflow y mira el log del job publish-npm:

gh workflow run Publish --ref v0.1.2

gh run watch --exit-status

Si dice OK: @james.valencia/mcp-reportia@0.1.2 publicado en el último step, está funcionando. Si vuelve a fallar, mandame el output del step "Publish" (sin el token).

Estado actual de los requisitos
PlataformaRequisitoEstado
npm Trusted PublishingConfigurar publisher en /package/@james.valencia/mcp-reportia/settings con javalenciacai/mcp-reportia + publish.ymlTu turno
Workflow Node 24Subir a Node 24 (lo hago yo tras tu confirmación)Pendiente
MCP RegistryNinguno — usa github-oidc que firma el workflow automáticamenteListo
skills.shNinguno — scraping automáticoListo
GitHub ReleasePermiso contents: write ya configurado en el workflowListo
Plan al terminar tu paso 1

Voy a ejecutar en este orden (no requiere tu input):

  1. Cambiar node-version: '22' → '24' en ambos jobs del workflow publish
  2. Verificar con npm test && npm run build local
  3. Commit + push
  4. Re-crear el tag v0.1.2 apuntando al nuevo commit
  5. Observar el workflow Publish hasta publish-npm exitoso
  6. Reportarte el resultado final (versión en npm + GitHub Release creado)
Hacer un release
# 1. Bump de version (esto actualiza package.json y server.json automaticamente)

cd /c/james/mcp-reportia npm version patch # 0.1.1 -> 0.1.2 (o minor/major)

2. Push del commit + tag a GitHub

git push origin main --follow-tags

(npm version ya crea el tag v0.1.2 y lo pushea junto con el commit)

GitHub Actions se dispara automáticamente:

  1. Job `validate` — typecheck + test + build + smoke. Verifica que package.json.version y server.json.version coincidan con el tag.
  2. Job `publish-npm` — publica a npm via OIDC (sin tokens de larga duración).
  3. Job `publish-mcp-registry` — publica server.json al MCP Registry oficial.
  4. Job `release` — crea un GitHub Release con notas auto-generadas.
Publicar manualmente (sin tag)

Si necesitas un release fuera del flujo normal, ve a GitHub → Actions → "Publish" → "Run workflow" y opcionalmente pasa un version override.

Rollback

Si necesitas revertir una versión publicada a npm (dentro de 72h):

npm unpublish @james.valencia/mcp-reportia@0.1.2

Después de 72h no es posible; debes publicar un patch. El MCP Registry no soporta rollback; hay que publicar una versión superior con la corrección.


Instalación y uso rápido

Una vez publicado, el consumo típico es vía npx:

# 1) Construir dist/ localmente (la primera vez, o al actualizar):

npm run build

2) Ejecutar el binario MCP directamente:

npx mcp-reportia

Los clientes MCP (Claude Desktop, Cursor, Hermes, etc.) lo invocan por ti como subproceso. No necesitas ejecutarlo a mano salvo para depurar.


Variables de entorno

VariableObligatoriaDescripción
REPORTIA_BASE_URLSíURL raíz de la API de Reportia, sin barra final (p.ej. https://reportia.example.com).
REPORTIA_TOKENCondicional\*Token Bearer. Alternativa al login por sesión.
REPORTIA_COOKIECondicional\*Cookie de sesión Reportia pre-emitida (p.ej. connect.sid=s%3A...). Para callers que ya tienen la sesión del usuario resuelta y quieren que el child autentique como ese usuario sin re-login.
REPORTIA_EMAILCondicional\*Email para login por sesión (cookie).
REPORTIA_PASSWORDCondicional\*Contraseña para login por sesión (cookie).
REPORTIA_COMPANY_IDNocompanyId por defecto cuando la tool lo admita. Acepta entero positivo.
REPORTIA_TIMEOUT_MSNo (def. 30000)Timeout por petición HTTP en ms.
REPORTIA_DOWNLOAD_DIRNo (def. ./downloads)Carpeta donde se guardan los binarios descargados (Excel/PDF exportados).
REPORTIA_USER_AGENTNo (def. mcp-reportia/0.1.0)Cabecera User-Agent en cada request.

\* Exactamente una de las tres alternativas de auth debe estar presente:

  • REPORTIA_TOKEN Bearer, o
  • REPORTIA_EMAIL + REPORTIA_PASSWORD sesión cookie (el package hace POST /api/auth/login y captura la cookie), o
  • REPORTIA_COOKIE sesión cookie pre-emitida (el package la usa directo, sin re-login).

Si pasás REPORTIA_TOKEN y REPORTIA_COOKIE a la vez, loadConfig lanza ConfigError con el mensaje REPORTIA_TOKEN y REPORTIA_COOKIE son mutuamente excluyentes — usa solo uno. para evitar que un token accidental sobreescriba una sesión per-user.

Precedencia cuando se establece una sola: cookie > bearer > session. cookie gana porque es la que matchea la identidad resuelta upstream; bearer es service-account; session es email+password login (el child se loguea a sí mismo).

Si no se establece ninguna, loadConfig lanza ConfigError al arrancar el servidor.

⚠️ No copies credenciales de C:\james\Reportia\.env a este repositorio. Este proyecto no debe contener secretos. Configúralas en el entorno del cliente MCP que lo invoque.

Revisa .env.example para ver todas las variables.


Configuración en clientes MCP

Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json)

Añade una entrada dentro de mcpServers:

{

"mcpServers": { "reportia": { "command": "npx", "args": ["-y", "mcp-reportia"], "env": { "REPORTIA_BASE_URL": "https://reportia.example.com", "REPORTIA_TOKEN": " ", "REPORTIA_COMPANY_ID": "123" } } } }

Sustituye mcp-reportia por la ruta local C:\\james\\mcp-reportia durante desarrollo, con args: ["-y", "--prefix", "C:\\james\\mcp-reportia", "mcp-reportia"] o ejecutando npm run start como comando directo.

Cursor (%USERPROFILE%\.cursor\mcp.json)
{

"mcpServers": { "reportia": { "command": "npx", "args": ["-y", "mcp-reportia"], "env": { "REPORTIA_BASE_URL": "https://reportia.example.com", "REPORTIA_TOKEN": " " } } } }

Hermes Agent (plugin MCP vía ~/.hermes/config.toml o UI)

Añade un servidor MCP stdio de nombre reportia apuntando a npx mcp-reportia y exporta las variables en env.

Formato típico:

[[mcp_servers]]

name = "reportia" command = "npx" args = ["-y", "mcp-reportia"] [mcp_servers.env] REPORTIA_BASE_URL = "https://reportia.example.com" REPORTIA_TOKEN = " " REPORTIA_COMPANY_ID = "123"

El nombre exac

ตัดมาแค่ช่วงต้น อ่านต่อใน repo