AI に渡す接続指示
AI アシスタントに接続を依頼する場合は、URL だけではなく次の内容をそのまま渡してください。
Vendex MCP に接続してください。
MCP endpoint:
https://mcp.aisfa.ai/mcp
Transport:
Streamable HTTP
Authentication:
OAuth 対応クライアントでは OAuth を使ってください。
OAuth 非対応クライアントでは Bearer token を使います。
Expected tools:
- aisfa_search_company_master
- aisfa_register_company_from_master
接続後、まず tool 一覧を確認し、上記 tool が見えるか確認してください。
まだ検索や登録は実行しないでください。前提
OAuth で接続する
OAuth 対応の MCP クライアントでは、API キーを手元に貼り付けずに接続できます。
claude mcp add --transport http aisfa https://mcp.aisfa.ai/mcpMCP URL を追加する
クライアントに Vendex MCP の URL を登録します。URL は /mcp で終わる Streamable HTTP エンドポイントを指定します。
ブラウザで Vendex にログインする
初回接続時に認可画面が開きます。操作対象の workspace と scope を確認して許可します。
tool 一覧を確認する
aisfa_search_company_master と aisfa_register_company_from_master が見えていれば、企業登録の準備は完了です。
Bearer token で接続する
OAuth 非対応クライアントに限り、Vendex の 設定 > 開発者 > API キー で発行した aisfa_ で始まる token を使います。
{
"mcpServers": {
"aisfa-remote": {
"transport": "streamable-http",
"url": "https://mcp.aisfa.ai/mcp",
"headers": {
"Authorization": "Bearer aisfa_xxxxxxxxxxxx"
}
}
}
}
API キーは workspace 単位の認証情報です。共有端末やチーム共通設定に入れる場合は、専用ユーザーと最小権限ロールを使ってください。
接続確認
まず tool 一覧だけを確認します。
Vendex MCP の tool 一覧を確認し、aisfa_search_company_master が利用可能か教えてください。まだ検索や登録は実行しないでください。tool が見えたら、次のように依頼し、tool call が実行されることを確認します。
Vendex の企業マスターで「サンプル株式会社」を検索して、候補を3件だけ表示してください。成功すると aisfa_search_company_master が呼ばれ、candidates 配列が返ります。
企業登録は Vendex のデータを更新します。
aisfa_register_company_from_master を使う前に、検索候補と登録先 workspace を確認してください。
うまく接続できない場合
- MCP URL が
https://mcp.aisfa.ai/mcpで、末尾が/mcpになっているか確認してください。 - transport が
streamable-httpまたは HTTP として設定されているか確認してください。 - OAuth の認可画面で、操作対象の workspace と scope を許可しているか確認してください。
- Bearer token を使う場合は、Authorization header が
Bearer aisfa_xxxxxxxxxxxxの形式になっているか確認してください。 - 企業検索には Companies の read 権限、登録には Companies の update 権限が必要です。
- tool 一覧に
aisfa_search_company_masterが表示されるか確認してください。