Typeship

@typeship-ax/mcp

Typeship API 用の MCP サーバーです。API リファレンス

OpenAPI または GraphQL Spec を解決して診断し、選択した各 CLI、MCP、SDK ターゲットを最新の状態に保ちます。

インストール

MCP クライアントは npx でサーバーを起動するため、個別にインストールする必要はありません（MCP クライアントの接続を参照）。代わりに typeship-mcp コマンドをグローバルにインストールするには、次を実行します。

npm install --global @typeship-ax/[email protected]

Node.js 20 以降が必要です。

MCP クライアントの接続

MCP クライアントの環境変数またはシークレット設定を通じて TYPESHIP_TOKEN を指定してください。認証情報の値を URL やコマンド引数に含めないでください。

ローカル

• Claude Code：claude mcp add typeship -- npx -y --package @typeship-ax/mcp typeship-mcp
• Codex：codex mcp add typeship -- npx -y --package @typeship-ax/mcp typeship-mcp
• VS Code にインストール

ローカル・読み取り専用

• Claude Code：claude mcp add typeship-readonly -- npx -y --package @typeship-ax/mcp typeship-mcp --read-only
• Codex：codex mcp add typeship-readonly -- npx -y --package @typeship-ax/mcp typeship-mcp --read-only
• VS Code にインストール

ホスト型

• Claude Code：claude mcp add --transport http typeship https://typeship.dev/mcp
• Codex：codex mcp add typeship --url https://typeship.dev/mcp
• VS Code にインストール

ホスト型・読み取り専用

• Claude Code：claude mcp add --transport http typeship-readonly https://typeship.dev/mcp/readonly
• Codex：codex mcp add typeship-readonly --url https://typeship.dev/mcp/readonly
• VS Code にインストール

その他のクライアント

クライアントの MCP 設定にサーバーエントリーを追加してください。Cursor の場合は .cursor/mcp.json の mcpServers にマージし、Cursor の MCP 設定でサーバーを有効にします。

{
  "mcpServers": {
    "typeship": {
      "command": "npx",
      "args": [
        "-y",
        "--package",
        "@typeship-ax/mcp",
        "typeship-mcp"
      ],
      "env": {
        "TYPESHIP_TOKEN": "replace-with-your-credential"
      }
    }
  }
}

MCP クライアントにシークレットストレージがある場合は、それを使って認証情報のプレースホルダーを置き換えてください。サーバーは環境変数から TYPESHIP_TOKEN を読み取ります。認証情報をコマンド引数に含めてはいけません。

サーバーは MCP 2025-11-25 と 2026-07-28 に対応しており、バージョンを自動的に選択するため、クライアントでプロトコルを設定する必要はありません。Claude Code に登録した後、claude mcp list で接続を確認できます。

ツール

サーバーはランタイム依存関係なしで stdio 経由で動作し、search_docs、read_docs、execute の簡潔な探索機能を提供します。操作を実行する前に読み取り、引数、例、安全性分類を確認してください。

ツールの入力スキーマは OpenAPI spec に基づいているため、エージェントには実際のパラメーター型と必須フィールドが表示されます。API に渡す前に引数を検証します（不明な引数や型が誤った引数がある場合は、何も破棄されず、単一の isError 結果として返されます）。すべてのツールは、必要な結果キーだけを残すための fields を受け取ります。また、エラーには安定した code と next_steps が含まれます。

書き込みできないサーバーにするには args に --read-only を追加するか、TYPESHIP_MCP_READ_ONLY=1 を設定します。公開するツールを一部に絞るには --tools projects,specs または TYPESHIP_MCP_TOOLS を指定します。結果サイズの上限（64,000）を変更するには TYPESHIP_MCP_MAX_RESULT_CHARS を設定します。

Typeship により OpenAPI spec から生成されています。