跳到主要内容

iApp AI MCP Server

iApp AI MCP 服务器把 iApp 的 API 作为工具提供给 Claude、Cursor、Codex 及任何 MCP 客户端：OCR、eKYC、语音、翻译、泰国法律数据，以及图像、幻灯片与视频生成。在客户端中添加下面的 URL，并用 iApp 账户登录即可。OAuth 会在服务器端关联您的 API key，无需复制；调用按正常 API 价格扣除积分。

https://mcp.iapp.co.th

连接客户端​

  1. 在 Claude Desktop 或 claude.ai 中打开 Settings → Connectors。
  2. 点击 Add custom connector。Name 填 iApp AI，URL 填 https://mcp.iapp.co.th，OAuth 字段留空。
  3. 点击 Connect，用 iApp 账户登录并批准。

之后用泰语或英语直接提问，助手会自行选择工具：

หาฎีกาที่ตีความ ป.อ. มาตรา 335 หลังปี 2560
แปลข้อความนี้เป็นภาษาญี่ปุ่น
Make me a 6-slide deck introducing our new product, clean corporate style
Generate a 10-second 720p video of a tuk-tuk driving through Bangkok at night

选择工具​

连接器默认提供最常用的服务：语音转文字、文字转语音、文档 OCR、泰国法律、最高法院、国务委员会与行政法院数据及有据可依的法律问答、人脸比对、静默活体检测、翻译、泰国身份证、驾照和护照 OCR、泰国假日、图像去背景、车牌识别，以及图像、幻灯片和视频生成。文件输入必须是公开的 http(s) URL，因为服务器在远端运行，无法读取您的磁盘。

每个工具定义在整个会话中都会占用助手的上下文。如需其他工具组合，在 URL 后加上查询参数；无法识别的名称会被跳过，不会导致连接失败。

  • https://mcp.iapp.co.th/?tools=all：远程服务器上的全部工具
  • https://mcp.iapp.co.th/?groups=legal：单一类别，上下文占用最小
  • https://mcp.iapp.co.th/?groups=default,llm：默认集合再加一个类别
  • https://mcp.iapp.co.th/?tools=iapp_translate,iapp_summarize：仅加载指定的工具

类别：speech、ocr、identity、face、vision、legal、data、nlp、llm、generation。

本地服务器​

iapp-mcp 包在您的机器上通过 stdio 运行，使用您自己的 API key。需要读取本地文件或使用全部工具时选择它。需要准备：

  • API key：登录后在控制面板打开 API Keys，点击 创建新 Key。密钥只显示一次。

  • uv（Python 3.10+）。npm 包（Node.js 18+）启动的是同一个 Python 服务器，因此两种方式都需要 uv：

    curl -LsSf https://astral.sh/uv/install.sh | sh    # 或者: brew install uv

  1. Claude Code：

    claude mcp add iapp-mcp -s user -e IAPP_API_KEY=YOUR_API_KEY -- uvx iapp-mcp

  2. Claude Desktop、Cursor 等使用 JSON 配置的客户端：

    {
      "mcpServers": {
        "iapp-mcp": {
          "command": "uvx",
          "args": ["iapp-mcp"],
          "env": { "IAPP_API_KEY": "YOUR_API_KEY" }
        }
      }
    }

在 Claude Code 中，-s user 把服务器添加到本机的所有项目，-s project 为仓库写入共享的 .mcp.json，默认的 -s local 仅限本机的当前项目。claude mcp list 应显示其已连接。

改为永久安装

任选其一安装：

uv tool install iapp-mcp     # 或者: pip install iapp-mcp
npm install -g iapp-mcp      # 或者: yarn global add iapp-mcp, 或者: pnpm add -g iapp-mcp

yarn dlx iapp-mcp 和 pnpm dlx iapp-mcp 无需安装即可运行。安装后以 iapp-mcp 启动：

claude mcp add iapp-mcp -s user -e IAPP_API_KEY=YOUR_API_KEY -- iapp-mcp
{
  "mcpServers": {
    "iapp-mcp": {
      "command": "iapp-mcp",
      "env": { "IAPP_API_KEY": "YOUR_API_KEY" }
    }
  }
}

检查服务器能否启动：

IAPP_API_KEY=YOUR_API_KEY iapp-mcp

工具参考​

在本地服务器上，文件输入是本机路径，生成的文件写入您指定的 output_path；远程连接器接收公开 URL，图像和幻灯片直接返回到对话中。每个工具的说明都标明其 IC 价格；响应中较大的 base64 字段会被截断，以免占用上下文。

eKYC
工具功能关键输入
iapp_thai_id_card_ocr读取泰国身份证file_path、side（front/back）
iapp_thai_id_card_photocopy_ocr读取身份证复印件并检测签名file_path
iapp_passport_ocr读取任意护照的 MRZ 和个人信息file_path、segmentation
iapp_thai_driver_license_ocr读取泰国驾照file_path
iapp_book_bank_ocr从存折读取户名和账号file_path
iapp_face_verification判断两张人脸照片是否为同一人（1:1）image1_path、image2_path、threshold
iapp_face_detection查找人脸及其边界框file_path、mode（single/multi）
iapp_face_liveness检测翻拍照片和屏幕欺骗file_path
iapp_face_id_card_kyc将自拍与身份证上的人脸比对id_card_path、selfie_path
iapp_face_recognition在公司人脸库中注册和搜索（1:N）action、company、file_path、name、password
泰语文档 OCR
工具功能关键输入
iapp_document_ocr任意泰语文档的 OCRfile_path、mode：text / layout / docx
iapp_receipt_ocr提取泰国收据的明细和总额file_path、return_ocr
iapp_credit_card_statement_ocr提取信用卡账单的交易file_path、return_ocr
iapp_tax_deduction_certificate_ocr读取代扣税证明（50 ทวิ）file_path、return_ocr
iapp_civil_registration_ocr读取泰国户籍证明file_path、return_ocr
iapp_resume_ocr提取简历的结构化数据并给出 AI 评估file_path
iapp_job_description_ocr提取职位描述的结构化数据file_path
大语言模型
工具功能关键输入
iapp_llm_chat与 iApp 托管的 LLM 对话（OpenAI 兼容）prompt 或 messages、model：deepseek-chat（默认）/ deepseek-reasoner / deepseek-v4-flash / deepseek-v4-pro、system_prompt、max_tokens、temperature
iapp_openthai_legal_chat回答泰国法律问题并返回所引用的法条；每 1K 输入 / 输出词元 0.01 / 0.02 ICprompt 或 messages、rag（默认 true）、rag_top_k、rag_inject（user/system）、max_tokens、temperature
iapp_thanoy_legal_qa泰国法律问答（Thanoy Legal AI）query
泰语 NLP
工具功能关键输入
iapp_translate在 28 种语言之间翻译text、source_lang、target_lang
iapp_summarize总结泰语或英语文本text、style、language
iapp_sentiment_analysis将泰语文本分为正面、中性或负面text
iapp_toxicity_classification检测有害的泰语文本text
iapp_thai_qa根据给定的泰语文档回答问题question、document
iapp_question_generation从泰语文本生成问答对text
语音
工具功能关键输入
iapp_speech_to_text转写音频并区分说话人file_path、language（th/en/zh）、quality（base/pro）
iapp_text_to_speech合成泰语语音并保存为音频文件text、output_path、voice、speed
iapp_voice_clone_tts用从样本克隆的声音朗读文本text、ref_audio_path、ref_text、output_path
iapp_ai_audio_detection判断音频是否由 AI 生成audio_path
图像、幻灯片与视频生成
工具功能关键输入
iapp_image_generation根据文本生成图像prompt、model
iapp_slide_generation生成一页完整的 16:9 幻灯片title、content、style、aspect_ratio、image_size
iapp_slide_deck_generation一次调用生成整套幻灯片，最多 8 页同时渲染slides[]、style、aspect_ratio、image_size
iapp_remove_background去除图像背景image_url（远程）/ file_path（本地）
iapp_video_generation_submit提交 Seedance 视频任务并返回 task idprompt、model、duration、ratio、resolution、generate_audio
iapp_video_generation_status轮询视频任务并返回下载 URLtask_id
  • 图像、幻灯片和视频生成需要付费账户，注册赠送的免费积分不能解锁。购买任意 IC 套餐即可使用视频生成。
  • 图像 3 IC（nanobanana）或 8 IC（nanobanana-pro）；幻灯片 8 IC；视频按输出 token 计费，5 秒 720p 片段约 27 IC。失败的视频任务和状态轮询为 0 IC。
  • 一页幻灯片渲染需要 15 到 30 秒；视频需要 30 秒到 4 分钟，因此采用先提交、再轮询的方式，下载 URL 有效期约 24 小时。
  • 反复调整幻灯片时传入 image_size: "1K"，最终渲染用 2K。生成的幻灯片适合标题页和概念页，不适合每个数字都必须准确的表格。
智慧城市与泰国数据
工具功能关键输入
iapp_license_plate_ocr识别泰国车牌file_path
iapp_meter_ocr读取电表和水表读数file_path
iapp_route_optimization为多名司机规划配送路线，最多 100 个站点origin_address + 坐标、stops、driver_count
iapp_thai_holidays查询泰国公共假日year，或 start_date + end_date，或不填
泰国法律数据
工具功能关键输入
iapp_thai_law_list法律目录，免费；请先调用以获取有效的法律名称q（可选名称过滤）
iapp_thai_law_section法条原文，可附上引用该法条的最高法院判决law、section、with_deka
iapp_thai_law_search根据泰语事实描述进行语义法条检索query、top_k（1–20，默认 8）
iapp_thai_deka_search在 133,159 份 ฎีกา 文书中检索判例，可按被引用法条筛选query、cites_law、cites_section、year_from、top_k
iapp_thai_deka_get按 ฎีกา 编号获取单个判决（1234/2565 或 1234-2565）case_id、include_body
iapp_thai_legal_ask有据可依的回答，引文经机器校验；绝不虚构案件编号question、include_deka
iapp_thai_krisdika_opinion_search按主题检索国务委员会意见，附官方 PDF 链接query、top_k
iapp_thai_admincourt_search按主题、当事人或案号检索行政法院判决，附官方 PDF 链接query、court、top_k

完整说明：泰国法律数据 API/MCP

故障排除​

iapp-ai 显示 Needs authentication

刚添加后属于正常状态：运行 /mcp，选择 iapp-ai → Authenticate 并登录。

本地 iapp-mcp 显示 failed，Windows 上常见

它需要 PATH 中有 uv；直接运行 uvx iapp-mcp 查看错误。也可以改用无需 uv 和 key 的远程服务器：先 claude mcp remove iapp-mcp，再 claude mcp add --transport http iapp-ai https://mcp.iapp.co.th。

所有工具都返回认证错误

IAPP_API_KEY 错误或已过期；用控制面板 API Keys 中的密钥重新添加服务器。

在其他项目中找不到服务器

添加时使用了默认的 -s local 作用域；改用 -s user 重新添加。

HTTP 402，积分不足

在控制面板充值；各工具价格见定价页面。账户付费前，视频生成请求会被拒绝。

© 2026 iApp Technology Co., Ltd.服务条款隐私政策系统状态sale@iapp.co.th