mottoMCP Server — 開発者向け

MCP Server

motto は Model Context Protocol (MCP) をサポートしています。AI エージェントから地域の投稿を検索・作成・マッチングできます。

エンドポイント

MCP エンドポイントhttps://motto-limited.up.railway.app/api/mcp
トランスポートstreamable-http
認証OAuth 2.0 (Authorization Code + PKCE)
OAuth メタデータhttps://motto-limited.up.railway.app/.well-known/oauth-authorization-server
レート制限 (認証済み)60 リクエスト / 分
レート制限 (未認証)10 リクエスト / 分

クイックスタート

Claude Desktop / Claude Code — mcpServers 設定

{
  "mcpServers": {
    "motto": {
      "transport": "streamable-http",
      "url": "https://motto-limited.up.railway.app/api/mcp"
    }
  }
}

Claude Code CLI コマンド

claude mcp add --transport http motto https://motto-limited.up.railway.app/api/mcp

提供ツール

search_posts自然言語または構造化クエリで投稿を検索する
get_post特定の投稿の詳細情報を取得する
create_post新しい投稿 (物品・スキルカテゴリ) を作成する
request_match投稿オーナーにマッチリクエストを送る
get_matchesユーザーが関与するマッチリクエスト一覧を取得する
negotiate_matchマッチリクエストに対してネゴシエーションアクションを行う

認証フロー

motto MCP Server は OAuth 2.0 Authorization Code フロー (PKCE 必須) で保護されています。MCP クライアントは以下の手順で認証します:

  1. OAuth メタデータを /.well-known/oauth-authorization-server から取得
  2. PKCE コードチャレンジを生成し、認可エンドポイントにリダイレクト
  3. ユーザーが motto アカウントで認証・認可
  4. 認可コードをアクセストークンと交換
  5. アクセストークンを使って MCP Server にリクエスト

関連リソース

MCP Server - motto