Likerts

Likerts MCP サーバー

MCP クライアントから、無料で利用できる MIT ライセンスの Likerts アンケートプラットフォームを操作できます。このサーバーは、HTTP API および CLI と同じ型付き操作と認可境界を公開します。

ホスト型サーバーは、公式 MCP レジストリに io.github.crosstabs/likerts として掲載されています。MCP クライアントで、ワークスペース ID とスコープ付きサービス認証情報を設定してください。この掲載によって、ワークスペースのデータが公開されることはありません。

インストール

npm から公開済みのバージョンをインストールします。

npm install --global @likerts/[email protected]

または、コミュニティリリースから MCP tarball をダウンロードし、npm install --global /absolute/path/to/the-mcp-package.tgz を実行します。Node.js 22 以降が必要です。

MCP クライアントが stdio 経由で likerts-mcp を実行するように設定します。LIKERTS_API_URL に API のオリジンを設定し、環境変数またはシークレットマネージャーを通じて、スコープ付きの LIKERTS_TOKEN を指定してください。ローカル API のデフォルトは http://127.0.0.1:8080 です。コレクション操作では別途 LIKERTS_COLLECTION_TOKEN を使用します。管理用認証情報を埋め込みアプリやツールの引数に含めないでください。

ローカル Codex 設定またはローカル Claude Code 設定をコピーしてください。どちらもサービス認証情報を環境変数から読み込みます。まずはワークフローに必要なスコープのみを設定してください。

ソースをチェックアウトした場合：

npm ci --prefix tools/mcp
npm run build --prefix tools/mcp
node tools/mcp/dist/main.js

MCP クライアントからコマンドを起動してください。stdout はプロトコルメッセージ用に確保されています。認証と権限のチェックは、引き続き API によって適用されます。

リモート接続

オプションのホスト型エンドポイントは https://likerts-mcp.onrender.com/mcp/{workspaceId} です。ワークスペースのスコープ付きサービス認証情報が必要です。合成された機密性のない評価データを使用するホスト型のリファレンスプレビューであり、Web プレビューと同じ運用上およびサポート上の制限があります。セルフホストする場合は、独自のリモートホストを使用してください。

Codex と Claude のセットアップ · クイックスタート · API リファレンス

レジストリのメタデータとリリースの検証

server.json は、公開済みのレジストリ掲載情報 0.1.1 と一致しており、リモートエンドポイントに加えて npm パッケージ @likerts/[email protected] が追加されています。公開ワークフロー は、ソース fe7588fabf2ee596a963ed943764021084f7d49e で 2026 年 9 月 13 日に成功しました。独立した読み戻しでも、npm とリモートの両方のメタデータが一致しました。掲載バージョンと npm パッケージのバージョンは別々に管理されます。レジストリの 0.1.0 と npm の tarball は変更できません。

Docker、Rust stable、Node 22 以降を備えたソースチェックアウトから、次を実行します。

npm ci --prefix tools/mcp
node scripts/check-mcp-registry.mjs
bash -c 'source scripts/dev-env.sh; node scripts/check-mcp-lifecycle.mjs'

レジストリのチェックでは、公式の固定スキーマ、npm パッケージの正確な ID とバージョン、公開済みの mcpName を検証します。ライフサイクルのチェックでは、一時的な利用側プロジェクトに公開 npm アーティファクトをインストールし、使い捨ての PostgreSQL と制限付きランタイムロールを使って、実際の Rust API をループバックで起動します。すべてのツールを検出し、スコープを限定したサービス認証情報を使って、アンケートの作成と公開、コレクションの作成、回答の送信・再試行・読み取り・削除、コレクションへのアクセスの終了を行います。また、スコープ不足による拒否と認証情報の失効も検証します。一時的なワークスペースとファイルは削除されます。特定の Codex／Claude UI、バックアップ／復元の動作、ホスト型サービスはテストしません。

メンテナーは、Verify foundations のプッシュ実行で必須の 2 つのジョブが両方とも成功した後に限り、正確な main コミットからメタデータを公開します。

gh workflow run publish-mcp.yml --ref main \
  -f source_sha=FULL_TESTED_MAIN_COMMIT \
  -f registry_version=NEW_UNPUBLISHED_REGISTRY_VERSION

このワークフローは、その SHA がディスパッチ時のコミットと一致することを必須とし、既存のレジストリバージョンがあれば処理を拒否します。また、スキーマ／npm／ライフサイクルのチェックを再実行し、リモートのヘルスチェックと認証拒否を確認したうえで、GitHub OIDC を使って公開し、作成されたレコードを検証します。npm の公開や、過去のコミュニティリリースの再ビルドは行いません。公開は成功したものの最終検証に失敗した場合は、再試行する前に該当するレジストリバージョンを調査してください。既存のレコードが上書きされることはありません。

インストール済みで、すでに認証されている Codex および Claude Code CLI を対象にオプトインでチェックするには、ライフサイクルコマンドに --clients を追加します。このチェックではアカウントの状態を事前確認し、認証済みの各クライアントに対して、空のローカルワークスペースで surveys_list と一時的な surveys:read 認証情報のみを使い、上限付きのモデルリクエストを 1 回実行します。アクセスを購入したり、クライアントのグローバル設定を変更したりすることはなく、通常の CI でも実行されません。各クライアントには 3 分のタイムアウトが設定されています。認証または承認が利用できない場合は、アカウント不要のプロトコルテストとは分けて報告されます。オプションの実行では、選択したすべてのクライアントが検証済みの空のツール結果を返さない限り、終了コードは 0 以外になります。認証後に Claude のみを再試行するには、--clients=claude を使います。クライアントの出力は、未加工のログや認証情報を公開せずに要約されます。

2026 年 9 月 13 日、Codex CLI 0.154.0 は、一時的なスコープ限定の PostgreSQL ワークスペースに対し、公開済みの @likerts/[email protected] 経由で surveys_list の呼び出しを正常に完了し、結果を検証しました。Claude Code 2.1.201 は設定を解析しましたが、認証はまだ完了していないため、実際のクライアント呼び出しは保留中です。クライアントの詳細な検証結果とオーナーのログイン操作を参照してください。以前の Codex の失敗は、テストハーネスが標準入力を開いたままにしていたことが原因でした。現在は即時 EOF と信頼性の高いタイムアウト追跡に対する回帰テストがあります。