시작하기
위험
이 API는 베타이며 사전 공지 없이 변경될 수 있습니다.
MCP로 AI 앱에서, 또는 API로 자체 도구에서 YouViCo 프로젝트를 다룰 수 있습니다.
MCP로 연결하기
Claude, ChatGPT 등 MCP를 지원하는 AI 앱을 연결하면 프로젝트에 대해 평소 말하듯 물어볼 수 있습니다.
- 아래 Claude에 바로 추가 버튼으로 Claude 디렉터리의 YouViCo를 엽니다.
- 커넥터를 연결하고 YouViCo에 로그인합니다.
- 워크스페이스와 API 권한을 선택하고 승인합니다.
연결한 뒤 앱에 질문합니다. 예: "Launch Campaign 프로젝트에 어떤 댓글이 달렸어?"
앱이 할 수 있는 일과 연결 해제 방법은 MCP를 참고합니다.
AI에게 맡기기
Claude, ChatGPT, Claude Code, Cursor 같은 AI 앱이나 코딩 도구에 아래 내용을 붙여 넣으면 AI가 설정을 대신 진행합니다.
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.
API 사용하기
API 키로 자체 도구에서 API를 직접 호출합니다.
1. API 키 생성하기
콘솔에 YouViCo 계정으로 로그인하고 워크스페이스용 키를 생성합니다. 연동에 필요한 API 권한도 함께 선택합니다.
주의
키는 한 번만 표시됩니다. 복사해서 안전한 곳에 보관해야 합니다.
2. 키 확인하기
Authorization 헤더에 키를 담아 Ping을 호출합니다.
curl 'https://api.youvico.com/api/ping' \
-H 'Authorization: Bearer YOUR_API_KEY'
응답에서 키가 속한 워크스페이스와 API 권한을 확인할 수 있습니다.
3. 첫 요청 보내기
해당 워크스페이스의 프로젝트를 검색합니다.
curl -X QUERY 'https://api.youvico.com/api/projects' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{ "keyword": "launch" }'
{
"data": [
{
"id": "bdbff5de-96d7-468f-9db0-85fe28bd6b62",
"name": "Launch Campaign"
}
],
"page": {
"next": null,
"prev": null
}
}