はじめに

危険

このAPIはベータ版で、予告なく変更される場合があります。

MCPを使えばAIアプリから、APIを使えば自社のツールから、YouViCoのプロジェクトを扱えます。

AIに任せる

Claude、ChatGPT、Claude Code、CursorなどのAIアプリやコーディングアシスタントに次の内容を貼り付けると、AIが設定を代わりに進めます。

text

Set up YouViCo for me by following https://developers.youvico.com/guides/getting-started.
- If you can connect MCP servers, add https://api.youvico.com/mcp as a remote MCP server and walk me through signing in.
- If I want code instead, have me create an API key, then build the integration with the guides and API reference at https://developers.youvico.com. Keep the key in the YOUVICO_API_KEY environment variable.
Reply in the language I write in.

MCPで連携する

Claude、ChatGPTなどMCPに対応したAIアプリを連携すると、プロジェクトについて普段の言葉で質問できます。

AIアプリで、次のURLのカスタムMCPコネクタを追加します。
```
https://api.youvico.com/mcp
```
YouViCoにログインし、ワークスペースと許可するスコープを選択します。
アプリに質問します。例：「Launch Campaignプロジェクトにどんなコメントが付いた？」

アプリでできることと連携の解除方法は、MCPを参照してください。

APIを使う

APIキーを使って、自社のツールからAPIを直接呼び出します。

1. APIキーを作成する

YouViCoアプリの 設定 → APIキー で、ワークスペースのキーを作成します。連携に必要なスコープを選択してください。

注意

キーは一度だけ表示されます。コピーして安全な場所に保管してください。

2. キーを確認する

Authorization ヘッダーでキーを送信し、Pingを呼び出します。

bash

curl 'https://api.youvico.com/api/ping' \
  -H 'Authorization: Bearer YOUR_API_KEY'

レスポンスには、キーが属するワークスペースとキーのスコープが表示されます。

3. 最初のリクエストを送る

そのワークスペースのプロジェクトを検索します。

bash

curl -X QUERY 'https://api.youvico.com/api/projects' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "keyword": "launch" }'

json

{
  "data": [
    {
      "id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62",
      "name": "Launch Campaign"
    }
  ],
  "page": {
    "next": null,
    "prev": null
  }
}

次のステップ

MCP: AIアプリをYouViCoに連携する
リクエストとレスポンス: リクエストとレスポンスの形式
権限: キーがアクセスできる範囲と実行できる操作
エラー: 失敗したリクエストの扱い方
APIリファレンス: すべてのエンドポイント

はじめに ​

AIに任せる ​

MCPで連携する ​

APIを使う ​

1. APIキーを作成する ​

2. キーを確認する ​

3. 最初のリクエストを送る ​

次のステップ ​