voa-tiss

npx skills add Voa-Health/tiss
claude plugin marketplace add Voa-Health/tiss && claude plugin install voa-tiss@voa-tiss
codex plugin marketplace add Voa-Health/tiss

Codexでは、~/.codex/config.tomlに追加します：

[mcp_servers.voa-tiss]
url = "https://tiss-api.voa.health/mcp"

Cursorでは、mcp.jsonに追加します：

{
  "mcpServers": {
    "voa-tiss": {
      "url": "https://tiss-api.voa.health/mcp"
    }
  }
}

サーバー用の追加機能をインストールし、ローカル API を起動します。

pip install "voa-tiss[server]"
python -m voa_tiss.server --host 127.0.0.1 --port 8000

XML を JSON として、または XML 本文として検証します。

python -c 'import json, pathlib; print(json.dumps({"xml": pathlib.Path("lote.xml").read_text()}))' \
  | curl https://tiss-api.voa.health/v1/validate \
  -H 'Content-Type: application/json' \
  --data-binary @-
curl https://tiss-api.voa.health/v1/validate \
  -H 'Content-Type: application/xml' \
  --data-binary @lote.xml

OpenAPI と 操作カタログを参照してください。

キーがない場合、サンドボックスの操作のみ応答します。それ以外の操作には、 tiss-api.voa.health/chavesで Voa アカウントにログインし、 受け取ったキーを送信してください。1 日あたりの上限はありません。

curl https://tiss-api.voa.health/v1/validate \
  -H "Authorization: Bearer $VOA_TISS_API_KEY" \
  -H 'Content-Type: application/xml' \
  --data-binary @lote.xml

キーの有効期間は 24 時間です。ログイン時に受け取った refresh_token で更新してください。キーが無効または期限切れの場合は 401 が返されます。

curl https://tiss-api.voa.health/v1/keys/refresh \
  -H 'Content-Type: application/json' \
  -d '{"refresh_token": "..."}'

このサービスはペイロードを保存・記録せず、モデルのトレーニングにも使用しません。 POSTHOG_KEY によって有効化される集計テレメトリーには、操作、 指摘事項のコード、ANS 登録情報、TISS バージョン、日付が含まれます。キーの発行時には、 メールアドレスを含まず、レベルと組織識別子が含まれます。無効にするには X-Voa-Telemetry: off を送信してください。ローカルライブラリはオフラインのままで、 テレメトリーを送信することはありません。VOA_TISS_API_KEY は、ローカル HTTP クライアントが アクセスキーを送信するために読み取れる変数です。

SP/SADTガイドをPDFでレンダリングするには、pip install "voa-tiss[pdf]"をインストールしてください。

voa_tiss.redeは、初回の検索時にデータをダウンロードして検証します。独自のコピーを使用するには、 VOA_TISS_REDEにローカルのSQLiteのパスを設定してください。