시작하기

위험

이 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에 로그인한 뒤 워크스페이스와 허용할 API 권한을 선택합니다.
앱에 질문합니다. 예: "Launch Campaign 프로젝트에 어떤 댓글이 달렸어?"

앱이 할 수 있는 일과 연결 해제 방법은 MCP를 참고합니다.

API 사용하기

API 키로 자체 도구에서 API를 직접 호출합니다.

1. API 키 만들기

YouViCo 앱의 설정 → API 키에서 워크스페이스용 키를 만듭니다. 연동에 필요한 API 권한도 함께 선택합니다.

주의

키는 한 번만 표시됩니다. 복사해서 안전한 곳에 보관해야 합니다.

2. 키 확인하기

Authorization 헤더에 키를 담아 Ping을 호출합니다.

bash

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

응답에서 키가 속한 워크스페이스와 API 권한을 확인할 수 있습니다.

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. 첫 요청 보내기 ​

다음 단계 ​