인플스 AI MCP 서버를
AI 클라이언트에 연결
MCP Server URL은 https://infls.ai/api/mcp입니다. AI 클라이언트는 OAuth Authorization Code + PKCE로 권한을 받고, access token과 refresh token을 발급받은 뒤 `tools/list`와 `/ai/tools`를 통해 도구 목록을 확인합니다.
사용자는 아이디와 비밀번호를 AI에게 입력하지 않습니다. Claude, Cursor, MCP Inspector 같은 클라이언트가 브라우저 OAuth 창을 열고, 사용자는 인플스 AI 로그인 화면에서 직접 로그인한 뒤 권한을 승인합니다.
공식 MCP endpoint는 `/api/mcp`이고, 도구 registry는 `/ai/tools`입니다.
공개 도구는 검색과 초안 작성 중심입니다. 캠페인 생성, 아웃리치 발송, 계약, 정산, 중재는 OAuth 권한이 있어야 호출됩니다. 보호 도구가 토큰 없이 호출되면 `/api/mcp`는 HTTP 401과 `WWW-Authenticate` 헤더를 내려 AI 클라이언트가 OAuth 플로우를 시작할 수 있게 합니다.
- MCP Server URL
- https://infls.ai/api/mcp
- Protocol Version
- 2024-11-05
- Transport
- streamable-http
- OAuth Discovery
- https://infls.ai/.well-known/oauth-authorization-server
- Tool Registry
- https://infls.ai/ai/tools
- OpenAPI
- https://infls.ai/openapi.json
인증 방식과 권한 범위
AI 클라이언트는 discovery metadata를 읽고 authorization endpoint, token endpoint, registration endpoint, refresh token 지원 여부를 자동 확인할 수 있습니다.
- Authorization
- /oauth/authorize
- Token
- /api/oauth/token
- Dynamic registration
- /api/oauth/register
- Refresh token
- grant_type=refresh_token
- Metadata
- /.well-known/oauth-authorization-server
- Protected resource
- /.well-known/oauth-protected-resource/api/mcp
- OpenID compatibility
- /.well-known/openid-configuration
AI에 비밀번호를 입력하지 않습니다
연결은 AI 채팅창이 아니라 브라우저 OAuth 로그인과 권한 승인 화면에서 끝납니다.
- 로그인 버튼 제공. 실제 Google OAuth credential이 설정된 환경에서 외부 브라우저 OAuth로 진행합니다.
- Kakao
- 로그인 버튼 제공. 실제 Kakao OAuth credential이 설정된 환경에서 외부 브라우저 OAuth로 진행합니다.
- Naver
- 로그인 버튼 제공. 실제 Naver OAuth credential이 설정된 환경에서 외부 브라우저 OAuth로 진행합니다.
- 이메일
- 매직링크가 아니라 이메일 6자리 인증코드 방식입니다.
- 비밀번호
- 일반 사용자 공개 로그인은 비밀번호를 받지 않습니다. ID/PW는 운영자 전용 /admin/login 및 내부 계정 설정 용도입니다.
MCP Inspector, Claude Desktop/Claude.ai, Cursor는 아래 설정 하나로 시작합니다. 클라이언트가 OAuth를 지원하면 이후 브라우저 로그인 창과 권한 승인 화면을 자동으로 열 수 있습니다.
서버 URL 또는 mcpServers JSON에 https://infls.ai/api/mcp를 넣고 OAuth를 선택합니다.
커스텀 MCP 서버 추가 화면에서 같은 JSON을 넣습니다. 인증은 브라우저로 열리는 인플스 OAuth 승인 화면에서 처리합니다.
프로젝트 또는 전역 MCP 설정에 같은 JSON을 넣고 Cursor가 여는 OAuth 브라우저 창에서 승인합니다.
Codex 앱 연결 UX
인플스는 Codex repo-local plugin으로 MCP 서버를 패키징합니다. 공식 Apps/Connectors 목록 노출은 OpenAI 측 connector registry 등록 이후 가능합니다.
레포에는 `plugins/infls-codex` 플러그인이 포함되어 있습니다. 이 플러그인은 Codex에 `infls` MCP 서버를 등록하고, 보호 도구 호출 시 브라우저 OAuth 로그인으로 이어지는 구성을 제공합니다.
- Plugin
- infls-codex
- MCP server name
- infls
- Fallback command
- codex mcp login infls
- OAuth resource
- https://infls.ai/api/mcp
{
"mcpServers": {
"infls": {
"url": "https://infls.ai/api/mcp",
"oauth_resource": "https://infls.ai/api/mcp",
"startup_timeout_sec": 20,
"tool_timeout_sec": 60
}
}
}Codex 앱 내부의 Apps/Connectors 화면에 인플스가 공식 버튼으로 노출되려면 OpenAI 쪽 connector 등록이 필요합니다. 그 전까지는 이 레포-local plugin, `/.well-known/ai-plugin.json`, OAuth discovery, protected-resource metadata, `WWW-Authenticate` challenge를 통해 Codex가 서버와 인증 방식을 발견할 수 있게 합니다.
48개 MCP Tool
각 도구는 name, description, permission, input_schema, output_schema, example을 포함합니다.
- search_influencers · search
- get_influencer_detail · search
- compare_influencers · search
- get_pricing_intelligence · search
- list_open_campaigns · campaign
- get_market_trends · search
- estimate_campaign_cost · search
- draft_outreach_messages · outreach
- submit_feature_request · support
- request_password_reset · support
- create_campaign · campaigns:write
- apply_to_campaign · authenticated:user
- list_campaign_applicants · brand:read
- accept_application · outreach:write
- call_manager · manager:call
- list_my_campaigns · brand:read
- send_outreach · outreach:write
- list_my_outreach · outreach:read
- get_outreach_thread · outreach:read
- reply_to_outreach · outreach:write
- create_contract · contracts:write
- sign_contract · contracts:write
- list_my_contracts · contracts:read
- get_contract_detail · contracts:read
- submit_deliverable · contracts:write
- release_escrow_payment · escrow:write
- get_my_notifications · notifications:read
- get_brand_profile · brand:read
전체 목록은 /ai/tools에서 JSON으로 확인합니다.
예제 요청과 응답
MCP는 JSON-RPC 2.0 요청을 사용합니다. 보호 도구 인증 실패는 HTTP 401과 WWW-Authenticate로 OAuth 시작 힌트를 제공합니다.
{
"mcpServers": {
"infls": {
"url": "https://infls.ai/api/mcp",
"auth": {
"type": "oauth"
}
}
}
}{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"clientInfo": { "name": "example-ai-client", "version": "1.0.0" }
}
}{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "search_influencers",
"arguments": {
"category": "beauty",
"platform": "instagram",
"min_followers": 10000,
"limit": 10
}
}
}{
"jsonrpc": "2.0",
"id": 2,
"result": {
"content": [
{ "type": "text", "text": "검색 결과 또는 처리 결과가 반환됩니다." }
]
}
}HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://infls.ai/.well-known/oauth-protected-resource/api/mcp", scope="campaigns:write"
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 3,
"error": {
"code": -32001,
"message": "인증이 필요합니다. AI 클라이언트를 인플스 AI 계정에 연결한 뒤 다시 시도해 주세요.",
"data": {
"authorization_required": true,
"resource_metadata": "https://infls.ai/.well-known/oauth-protected-resource/api/mcp",
"scopes_required": ["campaigns:write"]
}
}
}실제 클라이언트 성공 예시를 남기는 기준
성공 캡처는 클라이언트별 OAuth UI에서 사용자 계정 로그인이 필요하므로, 아래 기준으로 검증 후 문서에 추가합니다.
initialize 200, tools/list 46개 확인, 보호 도구 호출 시 401 challenge 확인, OAuth 승인 후 보호 도구 재호출 성공.
커스텀 MCP 서버 등록, 브라우저 OAuth 로그인, 권한 승인, token 발급, 보호 도구 호출 성공 화면을 캡처합니다.
.cursor/mcp.json 또는 커넥터 UI 등록, 브라우저 OAuth 로그인, token 발급, 보호 도구 호출 성공 화면을 캡처합니다.