Skip to main content
Glama
vehiclevisionjp

VehicleVision.PleasanterTools.McpOAuthWrapper

by vehiclevisionjp
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Remote

VehicleVision.PleasanterTools.McpOAuthWrapper

Pleasanter の MCP サーバーを、Claude などの AI アプリから OAuth で接続するための認証ラッパーです。

マニュアル

導入・設定・使い方・バージョンごとの対応は、 McpOAuthWrapper の公開マニュアルをご覧ください。

Related MCP server: GoHighLevel MCP Server

インストール

  1. Windows または Linux に ASP.NET Core Runtime 10 をインストールします。

  2. Release ページで使用するバージョンを選び、Assets の VehicleVision.PleasanterTools.McpOAuthWrapper-バージョン-portable.zip をダウンロードして展開します。Source code の ZIP は配布アプリではありません。

  3. 展開先で次のコマンドを実行し、http://127.0.0.1:5180/health/live に Healthy が表示されることを確認します。

    dotnet VehicleVision.PleasanterTools.McpOAuthWrapper.dll --urls http://127.0.0.1:5180

  4. 停止して 導入手順 に従い、データベースの読み取り専用接続、OAuth クライアント、証明書と公開 HTTPS URL を設定します。設定完了後に App_Data/Parameters/General.json の Enabled を true にして起動し、AI アプリへ公開 URL の /mcp を登録します。

初期設定は接続を無効にしており、起動確認だけでは MCP を利用できません。API キーは先に Pleasanter で発行しておきます。

OAuth の署名用・暗号化用証明書は、未指定の場合に有効期限10年で自動生成し、再起動後も同じものを使います。自分で用意した PFX のファイル／Base64、Windows 証明書ストア、Azure・AWS・GCP・OCI のシークレット管理からの取得も選べます。設定方法と証明書を削除した場合の影響は OAuth 証明書の設定を参照してください。

使い方

  1. AI アプリで管理者が用意したコネクタを選びます。接続先はラッパーの /mcp です。

  2. ラッパーのログイン画面で、Pleasanter で発行済みの API キーを入力します。

  3. 自分のアカウントを使うか、管理者が用意した共通アカウントを使うかを選びます。共通アカウントを設定していない場合、選択肢は表示されません。

  4. 接続する AI アプリと使用するアカウントを確認し、利用を許可します。

  5. AI アプリへ戻ると、Pleasanter の MCP 機能を利用できます。

API キーは接続時の認証に使い、ラッパーには保存しません。MCP 通信のたびに Pleasanter の Users テーブルから読み取ります。キーが未発行のアカウントはログインできません。先に Pleasanter で発行してください。キーの削除・再発行後は古い OAuth トークンを利用できないため、新しいキーで再接続します。

個人の API キーでログインした場合は、その本人を識別します。管理者が共通アカウントを設定していれば、その権限で接続することも選べます。共通の API キーを入力してログインした場合、識別・操作の主体は共通アカウントとなり、利用者個人は識別できません。

現在の対応範囲

OAuth 認可、個人／共通アカウントの選択、MCP の中継を実装した初期版です。Docker 上の Pleasanter 1.5.8.1／PostgreSQL 17 で OAuth 認可と MCP 接続を確認しています。SQL Server 2025・PostgreSQL 17・MySQL 8.4 は Docker で読み取り専用接続と Users の SELECT を確認済みです。初期設定では接続を無効にしています。導入後は認可から MCP 接続までを確認してください。

API キーを持っていることを認証根拠とします。Pleasanter のログインパスワードは使いません。LDAP・パスキー・二段階認証を使用する環境でも、Pleasanter で発行済みの API キーを使う方式です。ラッパーがそれらのログイン処理を実行したり、完了した証明を受け取ったりするものではありません。

画面は日本語・英語・中国語・ドイツ語・韓国語・スペイン語・ベトナム語に対応します。

OAuth の状態は SQLite（既定）または Redis／Valkey 互換 KVS に保存できます。KVS モードの設定とインスタンス間での共有方法は 導入手順を参照してください。API キーそのものはいずれの保存先にも保存しません。

資料

ライセンス

AGPL v3（AGPL-3.0-or-later）。LICENSE と NOTICE を参照してください。

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • GoHighLevel MCP Server

    Abrahamshal
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to interact with GoHighLevel CRM through MCP tools, with support for OAuth 2.1 remote deployment and agency multi-sub-account mode.
    -

  • JalinWP

    fatomate
    A
    license
    Not graded
    quality
    B
    maintenance
    An MCP gateway that enables AI clients to securely connect to WordPress and WooCommerce sites via OAuth, retrieve permitted content and data, and apply changes under configurable approval modes.
    GPL 2.0

  • mcp-app-server

    erzhiqianyi
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables existing apps to expose their users and data to external AI agents via MCP with OAuth 2.1 authentication and scoped tools.
    27 npm
    MIT