Palantir MCP 설치

Foundry의 MCP Hub에서 Palantir MCP 탭에 표시되는 설치 안내를 우선 사용합니다. Foundry 안의 VS Code 워크스페이스에서는 제공되는 AI development tools로 사용할 수도 있습니다.

로컬 연결은 사용자 토큰 권한으로 데이터를 외부 AI 시스템에 제공합니다. 외부로 읽힌 데이터의 이용 통제와 모델 제공자는 연결한 IDE 및 AI 서비스의 정책과 계약을 따릅니다. Palantir MCP를 연결했다는 이유로 Palantir의 모델이 사용되는 것은 아닙니다.

관리자 활성화

관리자가 Control Panel의 Code Repositories에서 Palantir MCP를 활성화해야 합니다. 특정 사용자나 그룹에만 허용할 수 있습니다.

인증 선택

Foundry Git 저장소 안에서 작업하면 Git 토큰으로 인증을 시작할 수 있습니다. 이 경우 별도 사용자 토큰을 만들거나 명시할 필요가 없습니다. Claude Code는 export FOUNDRY_TOKEN과 -e FOUNDRY_TOKEN을 모두 생략합니다. 나머지 IDE는 해당 env 블록을 생략하며 VS Code Copilot은 토큰을 묻는 inputs도 생략합니다.

Foundry 저장소 밖에서는 사용자 생성 토큰이 필요합니다. JSON/YAML 예제의 <token>과 <your-foundry-hostname>은 실제 설정 값으로 치환할 표기이며 비밀을 저장소에 커밋하지 않습니다. 호스트명에는 https://를 포함하지 않습니다. Claude Code의 셸 명령은 아래처럼 외부에서 제공한 환경변수를 사용합니다.

Claude Code

프로젝트 범위 설치가 권장됩니다. 서버 실행 인자는 -- 뒤에 전달합니다. 먼저 비밀 관리 도구나 셸 실행 환경에서 FOUNDRY_HOST를 제공하며, 저장소 밖에서 사용할 때는 FOUNDRY_TOKEN도 안전하게 제공합니다. 아래 검사는 필요한 값이 없으면 설명과 함께 중단합니다.

Foundry Git 저장소 안에서 연결

Git 토큰으로 인증을 시작하므로 별도 사용자 토큰 옵션을 넣지 않습니다.

: "${FOUNDRY_HOST:?Set FOUNDRY_HOST to your Foundry hostname without https://}"

claude mcp add palantir-mcp \
    --scope project \
    -- npx "-y" "palantir-mcp" "--foundry-api-url" "https://$FOUNDRY_HOST"

Foundry 저장소 밖에서 연결

FOUNDRY_TOKEN은 현재 셸과 이후 Claude Code를 시작하는 프로세스에 안전하게 공급해야 합니다. 작은따옴표로 감싼 '${FOUNDRY_TOKEN}'은 의도적인 리터럴입니다. 저장된 프로젝트 구성에 토큰 값 대신 환경변수 참조가 들어가도록 유지합니다.

: "${FOUNDRY_HOST:?Set FOUNDRY_HOST to your Foundry hostname without https://}"
: "${FOUNDRY_TOKEN:?Provide FOUNDRY_TOKEN through your secure environment}"
export FOUNDRY_TOKEN

claude mcp add palantir-mcp \
    --scope project \
    -e FOUNDRY_TOKEN='${FOUNDRY_TOKEN}' \
    -- npx "-y" "palantir-mcp" "--foundry-api-url" "https://$FOUNDRY_HOST"

Cline

Cline의 MCP 구성에 다음 서버 항목을 추가합니다. Foundry Git 인증을 사용할 때는 env를 제거합니다.

{
    "mcpServers": {
        "palantir-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "palantir-mcp",
                "--foundry-api-url",
                "https://<your-foundry-hostname>"
            ],
            "env": {
                "FOUNDRY_TOKEN": "<token>"
            },
            "disabled": false
        }
    }
}

Continue

Continue 구성은 아래 YAML을 사용합니다. --no-tool-search는 동적 도구 발견 대신 허용된 전체 목록을 처음부터 제공합니다.

mcpServers:
  - name: palantir-mcp
    command: npx
    args:
      - "-y"
      - "palantir-mcp"
      - "--no-tool-search"
      - "--foundry-api-url"
      - "https://<your-foundry-hostname>"
    env:
        FOUNDRY_TOKEN: "<token>"

Cursor

macOS에서는 stdio 서버로 npx를 실행합니다.

{
    "mcpServers": {
        "palantir-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "palantir-mcp",
                "--foundry-api-url",
                "https://<your-foundry-hostname>"
            ],
            "env": {
                "FOUNDRY_TOKEN": "<token>"
            }
        }
    }
}

Windows에서는 명령 해석기 실행 파일과 인자를 분리합니다. cmd가 /c 뒤의 npx를 실행하고 서버가 종료되면 명령 해석기도 종료합니다.

{
    "mcpServers": {
        "palantir-mcp": {
            "type": "stdio",
            "command": "cmd",
            "args": [
                "/c",
                "npx",
                "-y",
                "palantir-mcp",
                "--foundry-api-url",
                "https://<your-foundry-hostname>"
            ],
            "env": {
                "FOUNDRY_TOKEN": "<token>"
            }
        }
    }
}

GitHub Copilot과 VS Code

다음 전체 JSON 객체를 프로젝트의 .vscode/mcp.json에 저장합니다. inputs에서 비밀번호 입력을 받아 FOUNDRY_TOKEN에 연결하므로 <token>을 직접 치환하지 않습니다. Foundry Git 인증을 사용할 때는 inputs와 env를 생략합니다. 이 파일의 최상위 키는 inputs와 servers이며 settings.json의 속성 조각으로 넣는 구성이 아닙니다.

{
    "inputs": [
        {
            "type": "promptString",
            "id": "foundry-token",
            "description": "Foundry user token",
            "password": true
        }
    ],
    "servers": {
        "palantir-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "palantir-mcp",
                "--foundry-api-url",
                "https://<your-foundry-hostname>"
            ],
            "env": {
                "FOUNDRY_TOKEN": "${input:foundry-token}"
            }
        }
    }
}

이 구성은 VS Code의 대화형 입력 변수 처리 기능을 사용합니다. Copilot harness 세션에는 대화형 ${input:...} 구성이 전달되지 않을 수 있습니다. 해당 세션에서는 Foundry Git 인증을 사용하여 inputs와 env를 제거하거나 클라이언트가 지원하는 비대화형 자격 증명 구성으로 연결합니다.

Windsurf

Windsurf의 MCP 설정에 서버를 추가합니다.

{
    "mcpServers": {
        "palantir-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "palantir-mcp",
                "--foundry-api-url",
                "https://<your-foundry-hostname>"
            ],
            "env": {
                "FOUNDRY_TOKEN": "<token>"
            }
        }
    }
}

도구 목록 호환성

도구 검색은 기본으로 활성화됩니다. 클라이언트가 동적 tools/list_changed를 처리하지 못해 초기 도구만 보이면 서버 인자에 --no-tool-search를 추가하거나 PALANTIR_MCP_TOOL_SEARCH=false를 설정합니다. 이 설정은 도구 가시성만 바꾸며 권한을 늘리지 않습니다.