MCP プラグイン / OAuth 改善（v1.14.0）

状態: draft / 重要度: ★★★

TL;DR

v1.14.0 で MCP（Model Context Protocol）連携の 複数の致命的なバグ修正と機能改善 が入った
MCP ツールメタデータの自動更新、OAuth ディスカバリの堅牢化、サーバー URL の /v1 二重化バグ修正、スキーマ公開時の型マッピング修正
MCP 経由で外部ツールを Dify に統合している組織には、即時アップグレード推奨

想定読者

MCP サーバーを自社開発して Dify に繋ぎ込んでいる開発者
Anthropic の MCP エコシステムを Dify から活用しているチーム
プラグイン経由で外部ツールを大量に統合している運用者

なぜ重要か

MCP は v1.10 で実装されてから（v1.10 リリースノート）急速に Dify の標準的な拡張プロトコルになりつつある。しかし初期実装には:
- URL に /v1 が二重で付与されて 404
- OAuth ディスカバリのレスポンスが不正な JSON だとクラッシュ
- スキーマ公開時の型マッピング不備（checkbox、json_object）

といったプロダクションで実害のあるバグがあった。v1.14.0 でまとめて潰されている。

アウトライン（執筆予定）

1. MCP とは（軽くおさらい）

Anthropic 発のオープン標準
Dify における立ち位置（ツール / プラグイン / Knowledge Source）

2. v1.14.0 で入った修正・改善

項目	内容	インパクト
MCP ツールメタデータ	アップデート後に自動 refresh	UI と実装の食い違い解消
MCP サーバー URL	`/v1` 二重化バグ修正	OAuth/認可の 404 解消
MCP OAuth ディスカバリ	不正な JSON のセーフハンドリング	クラッシュ解消
MCP スキーマ公開	`checkbox` / `json_object` 型の正しいマッピング	開発者体験向上

3. プラグイン側の改善

auto-upgrade 戦略の永続化（バージョン管理が楽になる）
ローカルインストーラ・ファイル入力の挙動修正
inner API での end-user lookup のテナントスコーピング（マルチテナント環境のセキュリティ）

4. アップグレード前の注意点

MCP サーバーを自前運用している場合の互換確認
プラグインの強制再インストールが必要かどうか

5. 実装サンプル

v1.14.0 で動くようになる典型的な MCP 統合パターン

検証が必要な事項

[ ] /v1 二重化バグの再現条件と修正前後の差分
[ ] OAuth ディスカバリのエッジケース仕様
[ ] スキーマ公開時の型マッピング表（公式 Docs と突合）
[ ] 関連 PR 番号の特定

ソース:
- GitHub Release v1.14.0 — MCP and plugins セクション
- Anthropic MCP 仕様
- Dify Plugin Docs

本記事は非公式まとめです。正式仕様は Dify 公式ドキュメントをご確認ください。